.. highlight:: shell ============ Installation ============ Stable release -------------- To install cattrs, run this command in your terminal: .. code-block:: console $ pip install cattrs This is the preferred method to install cattrs, as it will always install the most recent stable release. If you don't have `pip`_ installed, this `Python installation guide`_ can guide you through the process. .. _pip: https://pip.pypa.io .. _Python installation guide: http://docs.python-guide.org/en/latest/starting/installation/ From sources ------------ The sources for cattrs can be downloaded from the `Github repo`_. You can either clone the public repository: .. code-block:: console $ git clone git://github.com/python-attrs/cattrs Or download the `tarball`_: .. code-block:: console $ curl -OL https://github.com/python-attrs/cattrs/tarball/master Once you have a copy of the source, you can install it with: .. code-block:: console $ pip install -e . .. _Github repo: https://github.com/python-attrs/cattrs .. _tarball: https://github.com/python-attrs/cattrs/tarball/master