gitnim linux_x64
choosenim for choosey nimions
What is It?
This program adds a git subcommand for Nim git nim
and installs itself
next to your Nim compiler so that if your compiler is in your PATH
, so is
gitnim.
The git nim
subcommand allows you to choose from precompiled Nim releases and
download/install them directly by managing your Nim installation as any other
git repository.
This Nim repository also links to the distribution from https://github.com/disruptek/dist, which is a hand-curated monorepo holding the most useful Nim modules from the ecosystem.
When run, gitnim displays or switches branches in the Nim repository and updates the dist submodules to ensure you always have easy access to the latest features and fixes as matched to your compiler.
Installation
Clone the Repository
We use git for distribution; what else?
$ git clone https://github.com/disruptek/gitnim
Add bin
to $PATH
A critical step; humor me on this one. The location of the compiler is used to infer the installation directory for gitnim itself.
$ export PATH=`pwd`/gitnim/bin:$PATH
Build gitnim
You now have a statically-linked Nim binary for your Linux-x64 system, so you can immediately compile gitnim.
This will automatically install the gitnim binary next to the compiler
binary according to your PATH
, enabling the git nim
subcommand.
$ cd gitnim
$ nim c gitnim/gitnim.nim
Usage
List Available Releases
With no additional arguments, git nim
will check the network for updates and
present the available Nim releases for selection.
The current distribution will be updated from the network, if necessary.
$ git nim
Choose a Release by Version
When a version is provided, git nim
will switch to that version immediately
without querying the network, provided the version exists locally.
The distribution will be updated without querying the network, if possible.
$ git nim 1.4.3
Choose a Release by Tag
When a tag is provided, git nim
will switch to the tagged version immediately
without querying the network, provided the tagged reference exists locally.
The distribution will be updated without querying the network, if possible.
$ git nim devel
$ git nim stable
Advanced Usage
Creating Your Own Nim Distribution
$ git checkout -b "my favorite nims"
Publishing Your Nim Distribution
$ git remote rename origin upstream
$ git remote add origin "git@github.com:your_name/gitnim.git"
$ git push --set-upstream origin "your branch name"
Adding a Custom Release Tag
$ git tag -a "tag_name" -m "your description"
Sharing Your Tags With Others
$ git push --tags
Revoking Your Tags With Others
$ git push --delete origin tag_name
Adding a Friend’s Tags
$ git remote add jeff https://github.com/jeff/gitnim
Using a Friend’s Tag
$ git nim jeff/1.3.3
Contributing
https://github.com/disruptek/gitnim
License
MIT