binman

Purposed-format binary application manager


License
MIT
Install
pip install binman==0.1.1

Documentation

binman

Binman is a lightweight tool for installing binaries provided in Github releases.

Installation

Via pip

pip install binman

Manually

$ git clone git@github.com:purposed/binman.git
$ cd binman
$ pipenv install
$ pipenv run python setup.py

Configuration

Binman's configuration file is located at ~/.config/purposed/binman/config.json.

Setting Type Default Value Description
default_code_host String github.com/purposed Default github org to use when only an application name is provided.
install_location String ~/bin Default location for the installed binaries.

Usage

Installing Software

$ binman [-v] install PACKAGE_PATH [VERSION]

This tool expects the releases to be named with a version number, and the binaries to be named along the following pattern: {name}-{platform}-{architecture}. When installing software, binman will detect your current platform & architecture, and select the correct binary.

By default, binman will put the binaries under ~/bin.

Updating Software

$ binman [-v] update PACKAGE_NAME [VERSION]...

For now, binman update PACKAGE VERSION is equivalent to binman uninstall PACKAGE && binman install PACKAGE VERSION. In the future, we will improve the update mechanism so it takes into account the package version pre-update.

Listing installed software

$ binman [-v] list

Uninstalling software

$ binman [-v] uninstall [PACKAGE_NAME]