Marc Cataford
7a1912c02a
* feat: basic use,install,list,help,init functionality * docs: README notes * refactor: argument parser documentation + removing redundant comments * feat: add uninstall command * feat: command ordering * build: shortcut tooling to build, format * feat: improve messaging around install progress * refactor: rename argparse utils * docs: more README notes
1.7 KiB
v
A version manager you might not want to use.
Overview
v is a simple version manager inspired from other tools like asdf, pyenv, n and nvm. At it's core, it's a reinvention of the wheel with some extras.
- First and foremost, while the first version is about Python version management, the plan is to expand to support a bunch more runtime (with an emphasis on simplifying adding more runtimes to manage);
- A lot of those tools are written as shellscript, which I find somewhat inscrutable. Go is a bit easier to read;
- ...? It's a reason to write some Go. :)
Roadmap
While the plan for the first release is to only support Python runtimes, expanding to others will be next so that v can just handle all/most version management needs.
Usage
Building your own and setting up
Pre-built binaries are not currently available. You can clone the repository and build your own via . scripts/build.
You should find a suitable place for the binary (/usr/local/bin is a good location) and if not already included, add its location to $PATH.
Finally, run v init to create directories to store artifacts and state (under ~/.v unless override using the
V_ROOT environment variable) and add ~/.v/shims to your $PATH as well.
Usage
v will print a helpful list of available commands.
The most important things to know include v install <version> to install new versions and v use <installed version> to use a specific version of Python.
Contributing
The project isn't currently accepting contributions because it's not yet set up to do so. Stay tuned.