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.
​
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.
- Download and extract Bump zip file to your Sublime Text Packages directory (Sublime Text -> Preferences -> Browse Packages...).
- Rename the extracted directory from
Bump-master
toBump
.
git clone https://github.com/yavorsky/Bump.git $HOME/Library/Application\ Support/Sublime\ Text\ 3/Packages/Bump
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.
- Focus the line inside
dependencies
/devDependencies
/peerDependencies
/optionalDependencies
block to preview latest or next version of the package. If tooltip option in settings isfalse
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.
Many options are customizable from the Command Palette (super + shift + p) and type Bump.
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.
Type: Boolean, Default: true
Whether or not show tooltip near the cursor. If tooltip is disabled, the version would be displayed in the botombar.
Type: Array, Default: ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]
Field name, where Bump will search and show latest version for current package.
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.
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.
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.