1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
|
.. _install:
Installation guide
==================
Version |release| of ``webcolors`` is officially tested and supported on the
following versions of Python:
* Python 3.10
* Python 3.11
* Python 3.12
* Python 3.13
* Python 3.14
Installing ``webcolors``
------------------------
To install the latest stable released version of ``webcolors``, run the following
command from a command prompt/terminal:
.. tab:: macOS/Linux/other Unix
.. code-block:: shell
python -m pip install --upgrade webcolors
.. tab:: Windows
.. code-block:: shell
py -m pip install --upgrade webcolors
This will use ``pip``, the standard Python package-installation tool. If you
are using a supported version of Python, your installation of Python should
have come with ``pip`` bundled. If ``pip`` does not appear to be present, you
can try running the following from a command prompt/terminal:
.. tab:: macOS/Linux/other Unix
.. code-block:: shell
python -m ensurepip --upgrade
.. tab:: Windows
.. code-block:: shell
py -m ensurepip --upgrade
Instructions are also available for `how to obtain and manually install or
upgrade pip <https://pip.pypa.io/en/latest/installation/>`_.
Installing from a source checkout
---------------------------------
If you want to work on ``webcolors``, you can obtain a source checkout.
The development repository for ``webcolors`` is at
<https://github.com/ubernostrum/webcolors>. If you have `git
<http://git-scm.com/>`_ installed, you can obtain a copy of the repository by
typing::
git clone https://github.com/ubernostrum/webcolors.git
From there, you can use git commands to check out the specific revision you
want, and perform an "editable" install (allowing you to change code as you
work on it) by typing:
.. tab:: macOS/Linux/other Unix
.. code-block:: shell
python -m pip install -e .
.. tab:: Windows
.. code-block:: shell
py -m pip install -e .
|