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.5

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.5
File Size Uploaded Provenance Actions
python_nss_ng-1.3.5.tar.gz 487.2 kB With provenance Details for python_nss_ng-1.3.5.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for python-nss-ng 1.3.5
File Actions
python_nss_ng-1.3.5-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.5-cp314-cp314-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.5-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.5-cp314-cp314-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.5-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.5-cp313-cp313-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.5-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.5-cp313-cp313-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.5-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.5-cp312-cp312-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.5-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.5-cp312-cp312-manylinux_2_38_aarch64.whl
python_nss_ng-1.3.5-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.5-cp311-cp311-manylinux_2_38_x86_64.whl
python_nss_ng-1.3.5-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.5-cp311-cp311-manylinux_2_38_aarch64.whl

Total release size: 13.8 MB

Release files / python_nss_ng-1.3.5.tar.gz

Download URL python_nss_ng-1.3.5.tar.gz
Size 487.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b92006fe8b9a47df346b9125b788dd27d7c70d8c5c755e81622c69b0029abf9f
BLAKE2b-256 checksum
How to use checksums
c4f64efb77e771674f57c018d3ffaea0537a7eb37857c4ea59ba8737709e0834
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
590bc78497f8f664157aac05d29cb925da1f229579c18964454e5dd62a352864
BLAKE2b-256 checksum
How to use checksums
3258064df7405d500cf9a0263b19599230c8ade85feaf1b2c293763abc55f4df
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
52f116bf71de1e1b6f533d28f3f088d9606d2df9080cfabfc954424f36a17bf7
BLAKE2b-256 checksum
How to use checksums
b2401e3845f9c3038d27bb7fa30b43def0fb925c88ef1849569d5cf6edd9d923
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
452624cfb51d5c05642b3e7a6d7fe8fdf577a35fd6e519bbcecde83bf5e27d83
BLAKE2b-256 checksum
How to use checksums
350828ecee8fc2b343b131b17a9dd6764db7c5f31ef3af3747f625bd38afa1b9
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
1289e3a37feefa3a84b5ac80b87a751451d6a6e424d1b7431006ea9725a68908
BLAKE2b-256 checksum
How to use checksums
5014dfb0569c5fc07306059093bea945c108e8cf3a7ba6f4ce236f7e9bcf16e7
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
c5c54ef17f3718ae92535505a61519c86022745f7afad6eaa50faeeb0e98a2b4
BLAKE2b-256 checksum
How to use checksums
d450f97a7ee281d4b8883ae40ebaf5b5b55bde4e223f54e20274363dd5e2c2ee
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
3e31d81788ea2cf6c7fc97bb7300de357bbbe416a697de7ee60cd0d5d6c46d92
BLAKE2b-256 checksum
How to use checksums
f5c946a9f87698ef0a542f184bc24120b1e33764e668a3075e12a7607f4c5d5e
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
13183fa678fe24dac5069a18a626849ee2a605e856f58efee37ab8268a338dd2
BLAKE2b-256 checksum
How to use checksums
c2a1d5351f2a3eac7e16bbe129379b15cb69e9d07622e708397890693caf265c
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 6, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.5-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
e20bb1ef415e3d7ee95e1d08632aadb09b0d1ddbe3ddb487c46ce70c0689367d
BLAKE2b-256 checksum
How to use checksums
b34e36fa02cb3ff3bc52fc5df140d8c620337d3df0a0b69b81ff44a51d4b4418
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 6, 2026.

Transparency log

Security for python-nss-ng 1.3.5

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 9 files in this release have been uploaded with provenance metadata.

Select from 9 files

Attestation for python_nss_ng-1.3.5.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 6, 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