Extendable version manager with support for Ruby, Node.js, Elixir, Erlang & more
Go to file
bootleq 897ea7f014 Provide dedicated message for obsolete shim case
When a shimmed command can't find usable plugin version, we used to do
several detection then output suggestion to user.

The original message assumes "preset" plugin version is not installed,
which could be false when shimmed command has old `asdf-plugin:` version
written, while not being updated when install newer plugin version.

Here add small `preset_plugin_installed` flag to detect if any
considered "missing" plugin is in fact exist. Print only simple message
for it.

Example output:

    Shimmed command 'yarn' has no matched plugin version
    Check the executable or try install yarn for your preset plugin version
2024-10-20 19:00:01 +08:00
.github chore(deps): bump dorny/paths-filter from 2 to 3 (#1718) 2024-10-07 13:57:17 +00:00
bin perf: only create dirs if they do not already exist (#1566) 2024-01-11 00:10:30 +11:00
completions fix: support asdf shim-versions completions in fish & bash (#1554) 2023-05-31 18:29:50 +10:00
docs chore(deps-dev): bump the docs group across 1 directory with 3 updates (#1786) 2024-10-08 00:51:50 +11:00
lib Provide dedicated message for obsolete shim case 2024-10-20 19:00:01 +08:00
scripts fix(nushell): Use def --env instead of def-env (#1681) 2024-01-13 16:55:07 +11:00
test Provide dedicated message for obsolete shim case 2024-10-20 19:00:01 +08:00
.editorconfig fix!: align Fish entrypoint behaviour with other shells (#1524) 2023-03-30 07:27:23 +00:00
.git-blame-ignore-revs chore: provide .git-blame-ignore-revs for easier investigation (#1465) 2023-01-29 16:33:23 +11:00
.gitattributes feat: Elvish Shell support (#1066) 2021-11-18 21:05:27 +11:00
.gitignore feat: Elvish Shell support (#1066) 2021-11-18 21:05:27 +11:00
.tool-versions fix: mv dev dep from repo root to subdir to avoid clash (#1408) 2022-12-30 20:25:32 +11:00
asdf.elv fix: update elvish to 0.18.0 2022-04-22 07:50:53 -04:00
asdf.fish fix(fish): use PATH instead of fish_user_paths (#1709) 2024-01-18 12:27:09 +11:00
asdf.nu fix(nushell): Use def --env instead of def-env (#1681) 2024-01-13 16:55:07 +11:00
asdf.ps1 feat: Support PowerShell Core (#1522) 2023-04-01 04:12:20 +00:00
asdf.sh fix: set default shell version values on POSIX entrypoint (#1594) 2023-09-11 00:42:55 +10:00
ballad-of-asdf.md fix ballad formatting 2017-06-10 10:06:48 -04:00
CHANGELOG.md chore(master): release 0.14.1 (#1773) 2024-08-19 11:18:33 -04:00
CONTRIBUTING.md docs: rewrite using Vuepress (#1000) 2021-07-23 15:26:21 +10:00
defaults feat: Support configurable ASDF_CONCURRENCY (#1532) 2023-04-19 13:45:51 +00:00
help.txt fix: list asdf version command under help.txt UTILS section (#1673) 2024-01-09 23:57:25 +11:00
LICENSE Add license file. Thanks to @mosic for reporting 2016-03-16 10:27:58 +05:30
README.md docs: fix broken link (#1401) 2022-12-28 15:49:28 +11:00
SECURITY.md chore(master): release 0.14.1 (#1773) 2024-08-19 11:18:33 -04:00
version.txt chore(master): release 0.14.1 (#1773) 2024-08-19 11:18:33 -04:00

asdf Lint Tests

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

asdf 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?

  • 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
  • shell completion available for common shells (Bash, Zsh, Fish, Elvish)

Documentation

Please head over to the documentation site for more information!

Contributing

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

Community & Questions

  • FAQ
  • GitHub Issues GitHub Issues: report a bug or raise a feature request to the asdf core team
  • StackOverflow Tag StackOverflow Tag: see existing Q&A for asdf. Some of the core team watch this tag in addition to our helpful community

Ballad of asdf

Once upon a time there was a programming language
There were many versions of it
So people wrote a version manager for it
To switch between versions for projects
Different, old, new.

Then there came more programming languages
So there came more version managers
And many commands for them

I installed a lot of them
I learnt a lot of commands

Then I said, just one more version manager
Which I will write instead

So, there came another version manager
asdf version manager - https://github.com/asdf-vm/asdf

A version manager so extendable
for which anyone can create a plugin
To support their favourite language
No more installing more version managers
Or learning more commands


This was the mail I wrote to a few friends to tell them about the project. Thanks to @roshanvid for suggesting that this go into the readme
@HashNuke