Skip to main content

Set of CLI commands to help manage a project

Project description

peltak is a command line tool to automate a lot of project related tasks. The tool should only wrap up existing project tools and not try to replace them. Also when implementing new commands lean towards just calling external tools rather than interfacing through the API. This way the commands implementation should resemble shell scripts in their structure and also serve as a reference on how to call the respective 3rd party tool without the use of peltak. Docker commands are a good example here as docker has a great python support but reading through the command implementation you know exactly what to do to do it manually and you probably don’t even have to know python.

WARNING: Beta: The project is mainly lacking good documentation and tutorials. The commands themselves are documented quite well, but there is no generic documentation or guides on how to extend and customize peltak.

Right now only peltak.core is unit tested. The commands themselves are tested manually in multiple projects that use peltak for day to day management and CI runs. Before 1.0, the commands implementation should also be unit tested. Only the CLI interface shouldn’t (e2e tests for that if any).


The CircleCI builds can be found here


$ pip install peltak

Enabling auto-completion

peltak has a great auto-completion thanks to the underlying click library. The steps to enable it vary slightly depending on what shell you are using

Bash users

Either run this command or to make the change permanent add it to your ~/.bashrc:

eval "$(_PELTAK_COMPLETE=source peltak)"
ZSH users

Either run this command or to make the change permanent add it to your ~/.zshrc:

eval "$(_PELTAK_COMPLETE=source_zsh peltak)"


Setting up development repo

$ git clone
$ cd peltak
$ virtualenv env
$ source ./env/bin/activate
$ pip install -r requirements.txt -r ops/devrequirements.txt
$ peltak git add-hooks

Running tests

Config: The types of tests are defined in and the pytest configuration is defined in ops/tools/pytest.ini.

$ peltak test

How to test for all supported python versions?

To run tox you need to first generate the requirements files. You can do this with pipenv lock -d --requirements > requirements.txt. Once it’s done, you can just run tox to test against python2.7, python3.4 and python3.6 all in one go.


Config: The list of locations to lint is defined in and the linters configuration is defined in ops/tools/{pylint,pep8}.ini.

$ peltak lint

Generating docs

Config: The list of documented files and general configuration is in and the Sphinx configuration is defined in docs/

$ peltak docs

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
peltak-0.24.5.tar.gz (52.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page