Julia Hansbrough | b65223d | 2015-04-13 17:30:58 -0400 | [diff] [blame] | 1 | Installation |
| 2 | ============ |
| 3 | |
| 4 | To install pyOpenSSL:: |
| 5 | |
| 6 | $ pip install pyopenssl |
| 7 | |
| 8 | If you are installing in order to *develop* on pyOpenSSL, move to the root directory of a pyOpenSSL checkout, and run:: |
| 9 | |
| 10 | $ pip install -e . |
| 11 | |
| 12 | |
Hynek Schlawack | 930525d | 2015-06-28 13:34:41 +0200 | [diff] [blame] | 13 | .. warning:: |
| 14 | |
| 15 | As of 0.14, pyOpenSSL is a pure-Python project. |
| 16 | That means that if you encounter *any* kind of compiler errors, pyOpenSSL's bugtracker is the **wrong** place to report them because we *cannot* help you. |
| 17 | |
| 18 | Please take the time to read the errors and report them/ask help from the appropriate project. |
| 19 | The most likely culprit being `cryptography <https://cryptography.io/>`_ that contains OpenSSL's library bindings. |
| 20 | |
| 21 | |
Hynek Schlawack | 6d97756 | 2016-12-11 15:38:18 +0100 | [diff] [blame] | 22 | Supported OpenSSL Versions |
| 23 | -------------------------- |
| 24 | |
| 25 | pyOpenSSL supports the same platforms and releases as the upstream cryptography project `does <https://cryptography.io/en/latest/installation/#supported-platforms>`_. |
| 26 | Currently that means: |
| 27 | |
Hynek Schlawack | 6d97756 | 2016-12-11 15:38:18 +0100 | [diff] [blame] | 28 | - 1.0.2 |
| 29 | - 1.1.0 |
Alex Gaynor | 2d2ea9d | 2019-02-03 01:16:05 -0500 | [diff] [blame] | 30 | - 1.1.1 |
Hynek Schlawack | 6d97756 | 2016-12-11 15:38:18 +0100 | [diff] [blame] | 31 | |
Hynek Schlawack | d52975c | 2017-05-13 17:44:27 +0200 | [diff] [blame] | 32 | You can always find out the versions of pyOpenSSL, cryptography, and the linked OpenSSL by running ``python -m OpenSSL.debug``. |
| 33 | |
Hynek Schlawack | 6d97756 | 2016-12-11 15:38:18 +0100 | [diff] [blame] | 34 | |
Julia Hansbrough | b65223d | 2015-04-13 17:30:58 -0400 | [diff] [blame] | 35 | Documentation |
Hynek Schlawack | 8fb864a | 2015-06-07 19:09:49 +0200 | [diff] [blame] | 36 | ------------- |
Julia Hansbrough | b65223d | 2015-04-13 17:30:58 -0400 | [diff] [blame] | 37 | |
| 38 | The documentation is written in reStructuredText and built using Sphinx:: |
| 39 | |
| 40 | $ cd doc |
| 41 | $ make html |