.. _install:

Installation
============

``django-latch`` |release| supports Django 4.2, 5.1 and 5.2. See
`Django's Python support matrix <https://docs.djangoproject.com/en/dev/faq/install/#what-python-version-can-i-use-with-django>`_ for details of which Python versions are
compatible with each version of Django.

Installing from PyPI
--------------------

To install ``django-latch``, run the following command from a command line:

.. tab:: Unix-based

    .. code-block:: shell

        python -m pip install django-latch

.. tab:: Windows

    .. code-block:: shell

        py -m pip install django-latch

This will install the latest supported version of Django, if you don't
already have one.

If you don't have ``pip`` installed on your computer, check
the `instructions on how to install it <https://pip.pypa.io/en/latest/installation/>`_.

Installing for local development
--------------------------------

If you want to contribute o modify any functionality, you can
obtain the source code from the `project repository <https://github.com/phoenixsite/django-latch>`_.
You can fetch it using `git <https://git-scm.com/>`_ by typing::

    git clone https://github.com/phoenixsite/django-latch.git