Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

An utility to easily manage your toolbox applications

Project description

# ToolBoxAssistant

An utility to easily manage your toolbox applications.

## Introduction

ToolBoxAssistant works by reading a JSON file containing the toolbox location and applications information.
By default it searches for a `toolbox.json` in the current directory. It can install applications from a
version control system (git / mercurial / subversion), or directly from an archive URL, and supports build
directives if needed.

## Installation

### From source

python install

### From PyPI

pip install ToolBoxAssistant

## Usage

usage: tba [-h] [-f FILE] [-v] {sync,genspec} ...

Easily manage your toolbox applications.

optional arguments:
-h, --help show this help message and exit
-f FILE, --file FILE toolbox specfile to use (default: toolbox.json)
-v, --verbose display debug information

{sync,genspec} (use "tba <cmd> -h" for commands help)
sync synchronize installed applications with specfile
genspec generate specfile from installed applications

### sync

Reads the specifications file, and automatically install listed applications, or updates them if they are already
installed. If the `-u`/`--unlisted` option is used, a warning is issued if versionned applications are installed
but not listed in the specfile.

usage: tba sync [-h] [-u]

optional arguments:
-h, --help show this help message and exit
-u, --unlisted list installed applications missing from specfile

### genspec

Searches for versionned applications in given folder and generate a specfile. If the `-m`/`--merge` option is used,
given file is updated.

usage: tba genspec [-h] [-m FILE] path

positional arguments:
path toolbox folder to scan for applications

optional arguments:
-h, --help show this help message and exit
-m FILE, --merge FILE
merge found applications with existing specfile

## The `toolbox.json` file

The following JSON example shows all the specifications that can be defined within the `toolbox.json` file:

"path": "/tmp/toolbox-example",
"apps": {
"sqlmap": {
"type": "git",
"url": "",
"path": "web/sqlmap"
"androguard": {
"type": "hg",
"url": "",
"path": "mobility/androguard"
"skipfish": {
"type": "svn",
"url": "",
"path": "web/skipfish",
"build": [
"nmap": {
"type": "archive",
"url": "",
"path": "network/nmap",
"build": [


## Bugs / Feature requests

If you find any bug, or have any feature you would like to see implemented, feel free to fill a ticket in the
issue tracker, or even better, fix/code it by yourself and do a pull-request.

## License

This project is licensed under the GNU GPLv3.

Project details

Release history Release notifications

This version


Download files

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

Files for ToolBoxAssistant, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size ToolBoxAssistant-0.1.tar.gz (21.0 kB) File type Source Python version None Upload date Hashes View hashes

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