Skip to main content

python-nss-ng

Platform Compatibility CI/CD Pipeline Python 3.11+ License: MPL-2.0

Python bindings for Network Security Services (NSS) and Netscape Portable Runtime (NSPR).

Supported Platforms

python-nss-ng officially supports:

  • Linux (all major distributions)
  • macOS

Windows is NOT supported. Attempting to import python-nss-ng on Windows will raise a RuntimeError.

Overview

python-nss-ng is a Python binding for NSS (Network Security Services) and NSPR (Netscape Portable Runtime). NSS provides cryptography services supporting SSL, TLS, PKI, PKIX, X509, PKCS*, etc. NSS is an alternative to OpenSSL and used extensively by major software projects. NSS is FIPS-140 certified.

NSS uses NSPR because NSPR provides an abstraction of common operating system services, in the areas of networking and process management. Python also provides an abstraction of common operating system services but because NSS and NSPR have tight coupling, python-nss-ng exposes elements of NSPR.

Project Modernization (2025)

This project received modernization work to support current Python versions and build standards:

Changes Made

  • Python Support: Now supports Python 3.11, 3.12, 3.13, 3.14, and 3.15
  • Build System: Migrated from legacy distutils to modern setuptools with pyproject.toml
  • Version Management: Implemented dynamic versioning using setuptools-scm
  • Package Structure: Follows current PEP standards (PEP 517, PEP 518, PEP 621)
  • Development Tools: Added support for uv, modern testing with pytest, and code quality with ruff

NSS/NSPR Compatibility

✅ C Extension Compatibility: The C code now compiles with NSS 3.100+ and works with NSS 3.117.

Recent Fixes:

  • Resolved typedef conflicts (RSAPublicKey → PyRSAPublicKey, etc.)
  • Fixed SPDX comment block formatting issues
  • All 32 tests pass with NSS 3.117 and NSPR 4.38

Tested Versions:

  • NSS 3.117
  • NSPR 4.38.2
  • Python 3.11, 3.12, 3.13, 3.14, 3.15

System Requirements

Required Libraries

Before building python-nss-ng, you need the C language header files and libraries for both NSPR and NSS installed. This is system and distribution specific.

Fedora/RHEL/CentOS

sudo dnf install nss-devel nspr-devel

Debian/Ubuntu

sudo apt-get install libnss3-dev libnspr4-dev

macOS (Homebrew)

brew install nss nspr

Installation

# Create a virtual environment with Python 3.11+
uv venv --python 3.11

# Activate the environment
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate  # Windows

# Install in development mode
uv pip install -e ".[dev]"

Using pip

# Create a virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install in development mode
pip install -e ".[dev]"

Custom Include/Library Paths

If NSS/NSPR live in non-standard locations, set the NSS_INCLUDE_ROOTS environment variable:

export NSS_INCLUDE_ROOTS="/custom/path/include:/another/path/include"
pip install -e .

Development

Test Dependencies

The test suite requires NSS command-line tools for certificate generation:

NSS Tools: Fedora/RHEL/CentOS

sudo dnf install nss-tools

NSS Tools: Debian/Ubuntu

sudo apt-get install libnss3-tools

NSS Tools: macOS (Homebrew)

The nss package includes NSS tools:

brew install nss

Running Tests

Quick Start (Automated)

Use the comprehensive test runner script that handles all setup:

# Run all tests (handles setup, builds C extension, creates certificates)
./scripts/run-all-tests.sh

# Quick mode: pure Python tests only (no C extension build needed)
./scripts/run-all-tests.sh --quick

# Other options
./scripts/run-all-tests.sh --help

The script automatically:

  • Checks for dependencies (uv, NSS, NSPR)
  • Creates virtual environment
  • Installs test dependencies
  • Builds C extension (if needed)
  • Sets up test certificates
  • Runs tests

Manual Testing

# Install with test dependencies
uv pip install -e ".[test]"

# Run tests (recommended for reliability)
pytest test/ -n0

# Or run with parallel execution (may have occasional intermittent failures)
pytest test/

Note: Some tests have known intermittent failures with parallel execution. Tests automatically generate certificates in a pki/ directory within the test folder using certutil from nss-tools. For fully reliable results, use -n0 to disable parallel execution. See TESTING.md for details about test reliability and certificate generation.

Building

# Build source distribution and wheel
uv pip install build
python -m build

Build Performance ⚡

Builds are now 40-80% faster thanks to automatic optimizations:

  • Probe Caching: Library locations cached (27% faster)
  • Parallel Compilation: Uses all CPU cores (40% faster)
  • ccache in CI: Compilation results cached (78% faster CI)

All optimizations work automatically! For even faster local builds:

# Optional: Install ccache for 87% faster rebuilds
brew install ccache  # macOS
export CC="ccache clang"

See BUILD_OPTIMIZATION_QUICKSTART.md for details.

Code Quality

Check code style and format code:

ruff check .
ruff format .

Project Structure

python-nss-ng/
├── src/                    # C extension source files and Python package
│   ├── __init__.py        # Main package initialization
│   ├── py_nss.c           # NSS bindings
│   ├── py_ssl.c           # SSL/TLS bindings
│   ├── py_nspr_io.c       # NSPR I/O bindings
│   └── py_nspr_error.c    # NSPR error handling
├── test/                  # Test suite
├── doc/                   # Documentation
├── pyproject.toml        # Modern Python project configuration
├── meson.build           # Meson build configuration
└── MANIFEST.in           # Source distribution file inclusion rules

Documentation

More information on python-nss-ng is available on the python-nss-ng project page.

For information on NSS and NSPR, see the following:

License

This project is triple-licensed under:

  • Mozilla Public License 2.0 (MPL-2.0)
  • GNU General Public License v2 or later (GPLv2+)
  • GNU Lesser General Public License v2 or later (LGPLv2+)

See LICENSE.mpl, LICENSE.gpl, and LICENSE.lgpl files for details.

Contributing

This is a modernization effort for an existing project. Contributions to fix the NSS compatibility issues and modernize the C code are welcome!

Priority Issues

  1. Fix C code compatibility with NSS 3.100+
  2. Update API usage for modern NSS/NSPR
  3. Add comprehensive test coverage
  4. Improve documentation
  5. Add type hints to Python code

Authors and Maintainers

  • Original Author: John Dennis jdennis@redhat.com
  • Current Maintainer: Project seeking active maintainer

Support

Metadata

Release files for python-nss-ng 1.3.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-nss-ng 1.3.7
File Size Uploaded Provenance Actions
python_nss_ng-1.3.7.tar.gz 487.0 kB With provenance Details for python_nss_ng-1.3.7.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for python-nss-ng 1.3.7
File Actions
python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_x86_64.whl CPython 3.15 CPython 3.15 Linux glibc 2.38+ x86-64 Details for python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_aarch64.whl CPython 3.15 CPython 3.15 Linux glibc 2.38+ ARM64 Details for python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.38+ x86-64 Details for python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.38+ ARM64 Details for python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.38+ x86-64 Details for python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.38+ ARM64 Details for python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.38+ x86-64 Details for python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.38+ ARM64 Details for python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.38+ x86-64 Details for python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_aarch64.whl CPython 3.11 CPython 3.11 Linux glibc 2.38+ ARM64 Details for python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_aarch64.whl

Total release size: 17.4 MB

Release files / python_nss_ng-1.3.7.tar.gz

Download URL python_nss_ng-1.3.7.tar.gz
Size 487.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f3b95b60021d6a31f53c7df6bff9909bd1139defae1ffe2823edd929f7f949d8
BLAKE2b-256 checksum
How to use checksums
9ec3721e4b1cbc28b7be0922b44b74b5a4390dfc816fd0a23ec99439cce678d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_x86_64.whl

Download URL python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_x86_64.whl
Size 1.7 MB
Tags CPython 3.15 Linux glibc 2.38+ x86-64
SHA-256 checksum
How to use checksums
a655ba160651da48549656cbda313b56e2043e31b6d05aea928dfa26c37cd9b9
BLAKE2b-256 checksum
How to use checksums
9957f1784a8c615490c5b58ebf9c24d006c7f5c337549c6b78e18ccafd52e395
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_aarch64.whl

Download URL python_nss_ng-1.3.7-cp315-cp315-manylinux_2_38_aarch64.whl
Size 1.7 MB
Tags CPython 3.15 Linux glibc 2.38+ ARM64
SHA-256 checksum
How to use checksums
4c667ad6435588958b8b4ba69df7016db8ec51cc92ee10e5042fc36af9f79214
BLAKE2b-256 checksum
How to use checksums
3bb4c9f08c98a1081b978b8b4f53efc801a9a8075af1170f0607685ea28ca68a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_x86_64.whl

Download URL python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_x86_64.whl
Size 1.7 MB
Tags CPython 3.14 Linux glibc 2.38+ x86-64
SHA-256 checksum
How to use checksums
1570859ffae897388e89fa5d50d7445e99a9f0f19dc2006a0eeddef55a08cdbf
BLAKE2b-256 checksum
How to use checksums
aff099cb26c28d7e8118b706dfde99f03bbe771913774811e6e63508db1a3a7d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_aarch64.whl

Download URL python_nss_ng-1.3.7-cp314-cp314-manylinux_2_38_aarch64.whl
Size 1.7 MB
Tags CPython 3.14 Linux glibc 2.38+ ARM64
SHA-256 checksum
How to use checksums
cfa65e3b3210e913e07041d0a86246ae141cea6525d47233c47aa06f246cb628
BLAKE2b-256 checksum
How to use checksums
8325fab73c176f930ed8ecd46fafe35366e31bbdbe2edf9a6c210c190ccc7aa8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_x86_64.whl

Download URL python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_x86_64.whl
Size 1.7 MB
Tags CPython 3.13 Linux glibc 2.38+ x86-64
SHA-256 checksum
How to use checksums
fe9f31fa9778558543f79a134f51f14c3c710390b0711044d661439998831007
BLAKE2b-256 checksum
How to use checksums
bbf0e66f02183b39a6b170f162f521ba181f5e8d8855981092eb62cebc9d92c7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_aarch64.whl

Download URL python_nss_ng-1.3.7-cp313-cp313-manylinux_2_38_aarch64.whl
Size 1.7 MB
Tags CPython 3.13 Linux glibc 2.38+ ARM64
SHA-256 checksum
How to use checksums
de364fe12bcf545d689a287d3272bbeaf4f49b5be6863124c6a43daa2b75328d
BLAKE2b-256 checksum
How to use checksums
05bae72e754afb7cc77330f435cfc347432cfbd3db1eb2e6f5298205dd1523bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_x86_64.whl

Download URL python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_x86_64.whl
Size 1.7 MB
Tags CPython 3.12 Linux glibc 2.38+ x86-64
SHA-256 checksum
How to use checksums
0e42d8709f4f8fb2e4cf90538700cad763a009525eb8d339a2969aeb2006c8f8
BLAKE2b-256 checksum
How to use checksums
d6e4a0b1f7bba3445cd7ad7206754eda9033a2b6fb9cb1b202b986b621588aac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_aarch64.whl

Download URL python_nss_ng-1.3.7-cp312-cp312-manylinux_2_38_aarch64.whl
Size 1.7 MB
Tags CPython 3.12 Linux glibc 2.38+ ARM64
SHA-256 checksum
How to use checksums
97c9f72d6dff073ccdb05415563528e564136f11417c273faf6c29e2454f2810
BLAKE2b-256 checksum
How to use checksums
76155e2e325f9605a11d95972fdcc72a8b03fae3811788bec02bfbb33eed6933
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_x86_64.whl

Download URL python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_x86_64.whl
Size 1.7 MB
Tags CPython 3.11 Linux glibc 2.38+ x86-64
SHA-256 checksum
How to use checksums
00f41f37980abb87921261c8ed439bfe2806dab5806dc755fc8231931af93a7b
BLAKE2b-256 checksum
How to use checksums
1804ae5e119ffb86a61fae420f2c733f3354b64f6af56700e77f82de6b827f6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_aarch64.whl

Download URL python_nss_ng-1.3.7-cp311-cp311-manylinux_2_38_aarch64.whl
Size 1.7 MB
Tags CPython 3.11 Linux glibc 2.38+ ARM64
SHA-256 checksum
How to use checksums
674873c27805583bf4ef2218c1ed8d36a2d55e8c3f207d80f7cb588ab1ca22a5
BLAKE2b-256 checksum
How to use checksums
97325f09829b74b325c9ffb6226a35730e6017e8fb13a9a7b9b6deeb0d21cd2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for python-nss-ng 1.3.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 11 files in this release have been uploaded with provenance metadata.

Select from 11 files

Attestation for python_nss_ng-1.3.7.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page