Reqs is a cross-platform Linux and MacOSX systems package management tool. It wraps apt, homebrew, dnf, yum, pip, npm and is able to automatically determine the right tool to use based on the system. It checks requirements files and/or reqs.yml files. Allows projects to clearly define their system package requirements and install them intelligently across multiple repositories and files.
The main focus of reqs is system package management abstraction with pip and possibly gem support added as an after thought to ease some project deployments. Because pip and ruby reqs generally don't differ from system-to-system abstracting those tools is not so important to reqs. If pip or npm arguments are specified the system package installation will be skipped, this functionality may change in the future.
Best way to use reqs is with a reqs.yml file in you repositories.
reqs.yml
common:
- curl
- git
apt:
- golang-go
brew:
- go
dnf:
- golang
Then run reqs in your repos and it'll install your system-level dependencies for you.
Can use separate requirements files, like how pip requirements.txt work with package names each on a new line and it tries to install the packages listed in it using either apt-requirements.txt, dnf-requirements.txt, brew-requirements.txt, or common-requirements.txt.
It can gather these requirements for multiple directories and/or recursively and combine them into a single installation call.
reqs automatically determines the tool to used based on the system and what is available.
Fast
bash -c "$(curl -sL https://raw.githubusercontent.com/iepathos/reqs/master/download.sh)"
Or download the latest release for your system from https://github.com/iepathos/reqs/releases
Or install with go if you're gopher inclined
go get -u github.com/iepathos/reqs/cmd/reqs
Automaticaly finds apt-requirements.txt, brew-requirements.txt, dnf-requirements.txt, common-requirements.txt, and reqs.yml files. common-requirements.txt are accepted for cross-platform shared same-name system dependencies.
For an example reqs.yml see https://github.com/iepathos/reqs/blob/master/examples/reqs.yml
Example dev setup https://github.com/iepathos/reup
view reqs args and their descriptions
reqs -h
recurse down directories to find requirements files and install the system depdencies
reqs -r
install all of the example projects' system pip and system npm dependenices
reqs -r -d examples -spip -snpm
install requirements in the current directory
reqs
get requirements from a specific directory, automaticaly detect appropriate -requirements.txt to use
reqs -d /some/path/
get requirements from a specific file
reqs -f tool-requirements.txt
get requirements from stdin
reqs -i < tool-requirements.txt
generate apt requirements from the currently installed apt packages
reqs -o > apt-requirements.txt
generate apt requirements with the versions info locked installed
reqs -ov > apt-requirements.txt
generate brew requirements from the currently install brew packages
reqs -o > brew-requirements.txt
update packages before installing requirements
reqs -u
update and upgrade packages before installing requirements
reqs -up
quiet mode squelch everything but errors
reqs -q
force reinstall of packages
reqs -force
Must have Go installed. Recent version is better. Relies on go-dep and go-releaser. release.sh will attempt to install/update both go packages and whatever other deps reqs has using dep. git tag the current commit you wish to release with the next appropriate version tag and run
./release.sh
Must export GITHUB_TOKEN with permission to push to origin master for the git repo. If you just fork off github.com/iepathos/reqs and then use a personal access github token with repo permission you should be groovy.
Cross-platform tests are executed using Vagrant https://www.vagrantup.com/ to define and manage Ubuntu, Fedora, and OSX virtual machines and execute reqs on example projects on those systems.
- refactor reqs code until it's beautiful
- add gem, npm, and bower comprehension or just stick to system packages?