Skip to content

yavorsky/Bump

Repository files navigation

Bump

A package allows to preview and manage latest versions of npm/yarn packages easily. Inspired by the vscode feature, but was rethought and enhanced.

For now, it allows:

  • Show latest released package version.
  • Show next (alpha, beta, etc) package version.
  • Compare semver versions and detect whether or not current version should be updated.
  • Format to latest or next version from the context menu.
  • Use custom registries.
  • Customize tooltip for your needs and taste.

Demo of latest usage

​

Installation

Install Bump via Package Control

The easiest and recommended way to install Bump is using Package Control.

From the main application menu (CMD + SHIFT + P), navigate to:

Tools -> Command Palette... -> Package Control: Install Package, type the word Bump, then select it to complete the installation.

Manual installation

via archive
  1. Download and extract Bump zip file to your Sublime Text Packages directory (Sublime Text -> Preferences -> Browse Packages...).
  2. Rename the extracted directory from Bump-master to Bump.
or via git clone

git clone https://github.com/yavorsky/Bump.git $HOME/Library/Application\ Support/Sublime\ Text\ 3/Packages/Bump

Usage

Just install the package and focus the line with dependency in package.json. Bump will preview latest or next version (according to the distribution mode) of the package in the bottombar or with the tooltip.

Main features:

  • Focus the line inside dependencies/devDependencies/peerDependencies/optionalDependencies block to preview latest or next version of the package. If tooltip option in settings is false then version will be displayed in the bottom bar.
  • Click on the version in the tooltip to format current version to the one from tooltip.
  • Click on Bump -> Format to... latest/next version from the context menu.
  • Choose distribution mode to change whether or not to fetch unreleased (alpha/beta/etc) version before relaesed.

Settings

Many options are customizable from the Command Palette (super + shift + p) and type Bump.

distribution_mode

Type: String, Default: latest

Command: Choose distribution mode.

Currently, Bump supports latest and next distribution tags. By default, the latest tag is used by npm to identify the current version of a package. The next tag is used by some projects to identify the upcoming version (alpha, beta, etc).

With next mode, package trying to fetch latest version, and if no one was registered, it fallbacks to the latest version.

tooltip

Type: Boolean, Default: true

Whether or not show tooltip near the cursor. If tooltip is disabled, the version would be displayed in the botombar.

dependency_fields

Type: Array, Default: ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]

Field name, where Bump will search and show latest version for current package.

supported_filenames

Type: Array, Default: ["package.json"]

Name of the files when Bump will watch out for your cursor. We haven't universal parser for all formats, but with json files it does its work.

Key Bindings

Bump has pre-defined keyboard shortcuts. For now, it format package value on the line with the cursor.

Command Key bindings
Format to latest ALT + SHIFT + L
Format to next ALT + SHIFT + N

For updates and more you can follow me on twitter.

License

Bump is released under the MIT License.

Copyright (c) 2017 Artem Yavorsky.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

🌱 Sublime Text 3 Plugin to keep package.json dependencies fresh.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages