Toolbox

Helps to discover and install tools.

Use cases

Toolbox started its life as a simple script in the phpqa docker image. Its purpose was to install set of tools while building the image. It has been extracted as a separate project to make maintenance easier and open itself for new use cases.

Installation

Get the toolbox.phar from the latest release. The command below should do the job:

curl -s https://api.github.com/repos/jakzal/toolbox/releases/latest \
  | grep "browser_download_url.*toolbox.phar" \
  | cut -d '"' -f 4 \
  | xargs curl -Ls -o toolbox \
  && chmod +x toolbox

Usage

List available tools

./toolbox list-tools

Install tools

./toolbox install

Test if installed tools are usable

./toolbox test

Tools definitions

By default resources/pre-installation.json and resources/tools.json are used to load tool definitions. Definitions can be loaded from customised files by passing the --tools option(s):

./toolbox list-tools --tools path/to/file1.json --tools path/to/file2.json

Tool definition location(s) can be also specified with the TOOLBOX_JSON environment variable:

TOOLBOX_JSON='path/to/file1.json,path/to/file2.json' ./toolbox list-tools