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

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

Built distributions (wheels)

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

Total release size: 14.0 MB

Release files / python_nss_ng-1.3.6.tar.gz

Download URL python_nss_ng-1.3.6.tar.gz
Size 487.2 kB
Tags Source
SHA-256 checksum
How to use checksums
4cde3d55859b6bb1ac7b3ce4b58c48ffa02800d31b71653f5eb709802bf80e75
BLAKE2b-256 checksum
How to use checksums
a33fc117eca9ddb7fb865b248ad26f02b83fa0997171da284f083ec66b9d7c94
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
b22f516a44ab79ea653444e8a64c351bfc2d715bf4903c990eae72d2bd434838
BLAKE2b-256 checksum
How to use checksums
01f0e0b6c914ee1783fec020e2524b5e58a6c3cf18a524604bad6ab4d8d0fd70
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
906408cd16b2bcf7f741ee9e1d012182a10aa7f11e8cedcf7143d104c68fc2ea
BLAKE2b-256 checksum
How to use checksums
d2aa1b05077ad8885f5b1007bac4264c24a6cc3902b2165234ee16a2ed248dd5
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
24a20bf9fcfe564d347cd9cdf77c38d77ace06e91675cbb0189e32e41b356b12
BLAKE2b-256 checksum
How to use checksums
6443153da11f1e3c09269527038a3de44e3a8b5af0b5577b16757b3e57f3ece9
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
738f51b6ae3abfba026ffafed1394eee3558ac7d292dcc3e636219e356a7a677
BLAKE2b-256 checksum
How to use checksums
fa1eb80c1bc0536d0cbc4a0151bdb70d8233f2cefabddca50a3e0062e9361931
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
3add2f629dd90bc33b0214ab12ac6524f51300c3e005adc3c01ce9353cfb3bf8
BLAKE2b-256 checksum
How to use checksums
dd0208d6329985249b9a9616281d1d973927e585a5c29495a5933b3a38bd9b2e
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
e129298a2af3aee657214bdfba74cf8803f3a7e2c6055740107888c36cff734b
BLAKE2b-256 checksum
How to use checksums
3315988adc1af8600edfa7297b806799265ba18169f93bf579e8e7d34214f397
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
261e47148704fcbd607f5c5a83f4a334892f57311a5f7578c4e93a8f493c2d8c
BLAKE2b-256 checksum
How to use checksums
4efb4cdc2fbf76d823a4a6c85dc046ab7ed1789cb60e79b37dc2fc44626f3935
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 12, 2026.

Transparency log

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

Download URL python_nss_ng-1.3.6-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
1f09a95dab00b37bc7dccc68e960799576d59bd2bd289fa0dfecf1d6ca371593
BLAKE2b-256 checksum
How to use checksums
e18f7c2a8e71cdb663f373d4767cb455efb47b2d662b1864f347c9f2a611edaa
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 12, 2026.

Transparency log

Security for python-nss-ng 1.3.6

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.6.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 12, 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