ex:

February 20, 2022 · View on GitHub

= relma - github RELease MAnagement cli :toc: left :sectnums:

image:https://github.com/jiro4989/relma/workflows/test/badge.svg[test] image:https://codecov.io/gh/jiro4989/relma/branch/master/graph/badge.svg[codecov, link="https://codecov.io/gh/jiro4989/relma"]

relma is the command to manage executables in GitHub Releases. relma helps you to upgrade one.

image:https://user-images.githubusercontent.com/13825004/97173868-94b00000-17d4-11eb-8f59-f3ca7fdb5ae6.gif[relma.gif]

== Motivation

It is pretty useful to versioning that the package management system like apt or yum. But we have to manage ourselves about executables in GitHub Releases.

Examples:

[source,bash]

cd /tmp wget https://github.com/jiro4989/nimjson/releases/download/v1.2.8/nimjson_linux.tar.gz tar xzf nimjson_linux.tar.gz mkdir -p ~/bin install -m 0755 ./nimjson_linux/bin/nimjson ~/bin/

We have to run those commands if we want to upgrade one.

I want to resolve this problem.

relma can upgrade your executables that installed with relma.

== Usage

At first, you have to run relma init to create configuration file.

Next, executables in GitHub Releases will be installed when you run relma init <release_url>. At default, symbolic links will be created in $HOME/relma/bin.

The entities will be stored in $HOME/relma/releases/<owner/repo>.

Examples: