Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zimfw/asdf
Sets up asdf, with auto install and optimized usage of the direnv plugin.
https://github.com/zimfw/asdf
asdf zim zimfw zsh zsh-plugin zsh-plugins
Last synced: about 1 month ago
JSON representation
Sets up asdf, with auto install and optimized usage of the direnv plugin.
- Host: GitHub
- URL: https://github.com/zimfw/asdf
- Owner: zimfw
- License: mit
- Created: 2021-08-07T03:25:17.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-06-21T18:25:45.000Z (over 1 year ago)
- Last Synced: 2024-10-03T09:57:46.015Z (4 months ago)
- Topics: asdf, zim, zimfw, zsh, zsh-plugin, zsh-plugins
- Language: Shell
- Homepage:
- Size: 3.91 KB
- Stars: 9
- Watchers: 2
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
asdf
====
Initializes [asdf], installing it using git if not installed yet. Also, bypasses
the shims if you're using the [direnv plugin], as suggested by the plugin
[pro-tips].
Settings
--------
The path of `ASDF_DIR`, where asdf is installed, is checked among the usual
directories created by Homebrew or Pacman, or the default `${HOME}/.asdf`. You
can define `ASDF_DIR` in your .zshrc before initializing this module to customize
its path:
ASDF_DIR=/path/to/asdf_dir
FAQ
---
### Do do I install the [direnv plugin] to work with this module?
1. Run these commands:
```
asdf plugin-add direnv
asdf direnv setup --no-touch-rc-file --version latest
```
2. Make sure your .zshrc does not contain the following line:
```
source "${XDG_CONFIG_HOME:-$HOME/.config}/asdf-direnv/zshrc"
```
### How to configure asdf to work with the direnv installed with my system package manager?
To use your system's direnv instead of direnv installed via asdf, follow these
steps:
1. Keep the asdf direnv plugin installed. You can install it with:
```
asdf plugin-add direnv
```
2. Uninstall any direnv installed with asdf:
```
asdf uninstall direnv
```
3. Make sure the ~/.config/direnv/lib/use_asdf.sh script exists. You can
generate it with:
```
asdf direnv setup --no-touch-rc-file --version system
```
4. Make sure your direnv .envrc files have `use asdf`.
5. Remove `zmodule asdf` from .zimrc or any asdf initialization from .zshrc.
6. Make sure you're initializing direnv during shell start-up, preferably with
`zmodule dirvenv` in your .zimrc.
Basically you're using direnv to activate asdf this way. Since you're using the
system's direnv, that does not depend on asdf to work, it's a much simpler setup.
[asdf]: https://github.com/asdf-vm/asdf
[direnv plugin]: https://github.com/asdf-community/asdf-direnv
[pro-tips]: https://github.com/asdf-community/asdf-direnv/blob/master/README.md#pro-tips