mirror of https://github.com/nucypher/pyUmbral.git
88 lines
1.8 KiB
ReStructuredText
88 lines
1.8 KiB
ReStructuredText
Installing pyUmbral
|
|
====================
|
|
|
|
|
|
Using pip
|
|
-------------------------
|
|
|
|
The easiest way to install pyUmbral is using ``pip``:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pip3 install umbral
|
|
|
|
|
|
Build from source code
|
|
-------------------------
|
|
|
|
pyUmbral is maintained on GitHub: https://github.com/nucypher/pyUmbral.
|
|
|
|
Clone the repository to download the source code.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ git clone https://github.com/nucypher/pyUmbral.git
|
|
|
|
Once you have acquired the source code, you can...
|
|
|
|
*...embed pyUmbral modules into your own codebase...*
|
|
|
|
.. code-block:: python
|
|
|
|
from umbral import pre, keys, config
|
|
|
|
*...install pyUmbral with pipenv...*
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pipenv install .
|
|
|
|
*...or install it with python-pip...*
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pip3 install .
|
|
|
|
|
|
Install dependencies
|
|
---------------------
|
|
|
|
The NuCypher team uses pipenv for managing pyUmbral's dependencies.
|
|
The recommended installation procedure is as follows:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ sudo pip3 install pipenv
|
|
$ pipenv install
|
|
|
|
Post-installation, you can activate the pyUmbral's virtual environment
|
|
in your current terminal session by running :code:`pipenv shell`.
|
|
|
|
If your installation is successful, the following command will succeed without error.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pipenv run python
|
|
>>> import umbral
|
|
|
|
For more information on pipenv, The official documentation is located here: https://docs.pipenv.org/.
|
|
|
|
|
|
Development Installation
|
|
-------------------------
|
|
|
|
If you want to participate in developing pyUmbral, you'll probably want to run the test suite and / or
|
|
build the documentation, and for that, you must install some additional development requirements.
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pipenv install --dev --three
|
|
|
|
|
|
To build the documentation locally:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pipenv run make html --directory=docs
|
|
|