kevin/asdf
1
Fork 0
mirror of https://github.com/asdf-vm/asdf.git synced 2024-11-15 01:28:17 -07:00
Code Issues Packages Projects Releases Wiki Activity
Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
1,077 Commits 19 Branches 39 Tags 20 MiB
Shell 90.3%
Python 3.6%
Nushell 3%
Elvish 2.8%
PowerShell 0.3%
0e8e1f8f84
Go to file
Victor Hugo Borja 0e8e1f8f84 New feature: asdf extension commands 
It's possible for plugins to define new asdf commands. This way plugins can extend asdf capabilities or expose utilities related to their managed tool.

For example, a `foo` plugin might expose the command `asdf foo bar` by providing an executable file at `bin/bar`.
If `bin/bar` is a file but has no executable bit set, then its considered a source-able bash script, and will be sourced
with all the functions in `$ASDF_DIR/lib/utils.sh` already loaded.

A good example of this feature is the `nodejs` plugin, where people must import the release team keyring before
installing a nodejs version. People can execute the following command without having to know where exactly is the plugin located.
2019-11-25 02:24:46 -06:00
.github Add github issue and pull request templates. 2017-08-08 11:25:21 -04:00
bin New feature: asdf extension commands 2019-11-25 02:24:46 -06:00
completions Fix fish completion to say latest returns a stable version 2019-11-22 10:37:53 -08:00
docs New feature: asdf extension commands 2019-11-25 02:24:46 -06:00
lib Add credit to xxenv-latest in comments 2019-11-22 10:37:53 -08:00
release Fix rc version check in release script 2019-03-31 21:14:46 +01:00
test New feature: asdf extension commands 2019-11-25 02:24:46 -06:00
.gitignore Add plugin-list-all command 2017-08-25 11:29:23 +09:00
.travis.yml Switch to latest version of BATS 2019-05-12 07:57:48 -04:00
appveyor.yml appveyor.yml: Add support for Windows 2019-08-24 23:51:20 +05:30
asdf.fish A different approach 2019-07-22 18:44:32 -05:00
asdf.sh Check for bash before mksh 2019-03-31 20:44:49 +01:00
ballad-of-asdf.md fix ballad formatting 2017-06-10 10:06:48 -04:00
CHANGELOG.md New feature: asdf extension commands 2019-11-25 02:24:46 -06:00
CONTRIBUTING.md de-dupe readme and finalise docs site (#441) 2019-01-29 22:31:34 +11:00
defaults Add support for config file. 2016-04-24 22:39:24 +09:00
help.txt Update help.txt 2019-03-20 19:08:40 +00:00
LICENSE Add license file. Thanks to @mosic for reporting 2016-03-16 10:27:58 +05:30
lint.sh Correct release script filename in lint.sh 2019-03-24 18:39:47 -04:00
prepare-travis.sh Add fish to Travis build 2019-04-07 15:01:19 -04:00
README.md Add AppVeyor badge to readme 2019-11-02 15:11:20 -04:00
Vagrantfile Add a Vagrantfile to test on ubuntu 2015-05-19 11:00:40 +05:30
VERSION Update version to 0.7.5 2019-11-04 19:42:50 -05:00

README.md

asdf-vm Build StatusBuild status

Manage multiple runtime versions with a single CLI tool, extendable via plugins - docs at asdf-vm.com

asdf-vm is a CLI tool that can manage multiple language runtime versions on a per-project basis. It is like gvm, nvm, rbenv & pyenv (and more) all in one! Simply install your language's plugin!

Why use asdf-vm?

  • single CLI for multiple languages
  • consistent commands to manage all your languages
  • single global config keeping defaults in one place
  • single .tool-versions config file per project
  • support for existing config files .node-version, .nvmrc, .ruby-version for easy migration
  • automatically switches runtime versions as you traverse your directories
  • simple plugin system to add support for your language of choice
  • completion scripts managed by the plugin, not you!

Documentation

Please head over the documentation site for more information!

Contributing

See CONTRIBUTING.md in the repo or the Contributing section on the docs site.