Installation ============ :program:`scd` is simple Python package which hosted on `Cheese Shop `_ so if you are familiar with Python package installation, it would be really straightforward. Tool works with Python>=2.7 and PyPy2. Prerequisites +++++++++++++ To install scd, you need to have pip or setuptools installed. Pip is required if you want to install it from Cheese Shop and setuptools if you prefer source code installation. To install `Pip `_ follow these guides: * `Installation with package managers `_ * `Installation without package managers `_ To install setuptools follow `official guide `_ and please check repository of your OS: there is a great possiblity that you already have it installed. .. _installation-install-from-cheese-shop: Install from Cheese Shop ++++++++++++++++++++++++ If you want to install system-wide or in virtualenv then do .. code-block:: bash pip install scd Otherwise, please do .. code-block:: bash pip install --user scd Also, it is possible to use following extras to add some optional features to your installation. +------------+---------------------------------------------+ | Name | Description | +============+=============================================+ | yaml | Enable support of YAML configuration files. | +------------+---------------------------------------------+ | toml | Enable support of TOML configuration files. | +------------+---------------------------------------------+ | simplejson | Use simplejson for JSON parsing. | +------------+---------------------------------------------+ | colors | Enable support of colors in output. | +------------+---------------------------------------------+ So if you want to install scd with YAML support and colors enabled, please do following: .. code-block:: bash pip install scd[yaml,colors] Install from sources ++++++++++++++++++++ .. code-block:: bash git clone https://github.com/9seconds/scd cd scd python setup.py install Verify that tool is installed with ``scd --help``.