paulgoetze/asdfg

Installing global asdf packages from a YAML config

asdfg

Installing global asdf packages from a YAML config.

asdfg requires asdf to be installed and allows to configure and install/update multiple versions of asdf-plugins by a single cli command.

Installation

Install it via cargo:

$ cargo install asdfg

or install it manually:

• download the asdfg binary file from https://github.com/paulgoetze/asdfg/releases.
• make it executable by running sudo chmod +x asdfg
• move it into your favorite directory
• add the asdfg executable to your system path

Getting Started

You can open the asdfg YAML configuration file with your default editor by running:

$ asdfg config open

The YAML config is by default stored in ~/.asdfg/config.yaml. You can customise the config path with the --config or -c option.

Add the asdf packages you want to install with their respective versions here, e.g.:

# ~/.asdfg/config.yaml

rust:
  - 1.39.0
  - latest
python: latest
erlang: latest
elixir:
  - 1.9.3
  - latest
golang: latest

The keys must match an asdf plugin name, the version(s) can either be a single value or a list of versions. All version must be available via the asdf plugin. The last version for each asdf plugin is set to be the globally used version, when running:

$ asdfg install

In order to install all configured version of a specific asdf plugin, run:

$ asdfg install <plugin-name>

For further commands, please have a look at the cli documentation:

$ asdfg --help

License

asdfg – Installing global asdf packages from a YAML config.
Copyright (C) 2020, Paul Götze

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/.