wolfcrypt 5.9.2.post0

Compiling

pip install uv

uv build --sdist

Installation

We provide Python wheels (prebuilt binaries) for OSX 64 bits and Linux 64 bits:

$ pip install wolfcrypt

To build wolfcrypt-py against a local installation of the native C wolfSSL library, use the USE_LOCAL_WOLFSSL variable. This variable should be

wolfcrypt-py can be built against a local version of the native wolfSSL library by using uv build –wheel with the USE_LOCAL_WOLFSSL variable. USE_LOCAL_WOLFSSL should be set equal to the installation path for the wolfSSL library:

$ USE_LOCAL_WOLFSSL=/path/to/wolfssl/install uv build --wheel

If building wolfcrypt-py against a local wolfSSL library, wolfcrypt-py will attempt to do native feature detection to enable/disable wolfcrypt-py features based on how native wolfSSL has been compiled. It uses the <wolfssl/options.h> header to do feature detection.

After this the local build can be installed from the locally built wheel in dist.

$ pip install dist/wolfcrypt*.whl

Testing

$ uv run python3

>>> from wolfcrypt.hashes import Sha256
>>> Sha256('wolfcrypt').hexdigest()
b'96e02e7b1cbcd6f104fe1fdb4652027a5505b68652b70095c6318f9dce0d1844'

Testing wolfcrypt’s source code with pytest

To run the unit tests in the source code, you’ll need uv and a few other requirements.

1. Make sure that the testing requirements are installed:

$ uv sync --dev

2. Run pytest:

$ uv run pytest
======================================= test session starts =======================================
platform linux -- Python 3.10.12, pytest-9.1.1, pluggy-1.6.0
rootdir: /some_directory/wolfcrypt-py
configfile: pyproject.toml
collected 165 items

tests/test_aesgcmstream.py .........                                                        [  5%]
tests/test_asn.py ..                                                                        [  6%]
tests/test_chacha20poly1305.py ......                                                       [ 10%]
tests/test_ciphers.py ...........................................                           [ 36%]
tests/test_delete_descriptor_binding.py .................                                   [ 46%]
tests/test_error_string.py ....                                                             [ 49%]
tests/test_hashes.py ...........................                                            [ 65%]
tests/test_hkdf.py ........                                                                 [ 70%]
tests/test_mldsa.py ..............................                                          [ 88%]
tests/test_mlkem.py ............                                                            [ 95%]
tests/test_pwdbased.py .                                                                    [ 96%]
tests/test_random.py ......                                                                 [100%]

======================================= 165 passed in 7.09s =======================================