Installation ============ End user installation --------------------- :program:`pip` is your friend here! If you have it in your path, you can simply use:: pip install pyimgren It will take care of any required dependencies and will install the latest version of pyimgren. It will also install a :program:`pyimgren` command that will be directly callable from a shell (:ref:`ref `). If it is not in your path, it is likely that you have to use the :program:`py` launcher. In that case you use :program:`pip` as:: py -m pip install pyimgren The installation is exactly the same as it is when launching directly :program:`pip`. But you will have to still use the :program:`py` launcher to call pyimgren from a command line :ref:`ref `. Developper installation ----------------------- The source is of course available on `PyPI `_. But the tests directory is only available on GitHUB. Here again, you can download the full source for the relevant version, but the recommended way is to use Git to clone the repository. It will give you all the versions in one single operation, as well as a nice environment if you want to later send a pull request. So simply do:: git clone https://github.com/s-ball/pyimgren.git pyimgren Beware: integration tests require `pyfakefs `_. See :doc:`testing` for more. .. note:: The various untagged commits in the Git hierarchy are not guaranteed to be directly useable. At some points, some tests can fail and unexpected errors can occur. Use the master branch when you want to contribute. In any other cases, stick to a release, or be sure to pass all tests and be prepared to look into the source code if something goes wrong.