neutronium

Framework-agnostic Python utilities, extracted from Gaussian's internal infrastructure. No Django, no web framework, no cloud SDK in the base install — everything third-party is an optional extra.

pip install neutronium              # base: zero dependencies
pip install neutronium[text]        # inflection-backed pluralize/singularize
pip install neutronium[xpath]       # lxml-backed HTML/XPath helpers

What's inside

Module	What it gives you
`neutronium.utils.text`	Text normalization, slugs, tokenization, pluralize/singularize
`neutronium.utils.time`	Timezone-aware datetime helpers
`neutronium.utils.iterable`	Chunking, grouping, flattening, dict utilities
`neutronium.utils.template_context`	Pure template-variable extraction and context building
`neutronium.utils.json_patch`	RFC-6901 JSON pointer / merge-patch primitives
`neutronium.utils.hash`	`blake2b` content hashing helpers
`neutronium.utils.schema`	JSON-schema → default-dict
`neutronium.utils.xpath`	lxml HTML parsing + link extraction (`[xpath]`)
`neutronium.utils.url`	URL parse / canonicalize / normalize / domain extraction (`[url]`)
`neutronium.requester`	Resilient HTTP fetcher with retries/paywall/no-index detection (`[requests]`)
`neutronium.utils.file`	Pickle / text / JSONC file helpers
`neutronium.utils.performance`	Simple multi-level timer
`neutronium.utils.email`	Canonical email normalization
`neutronium.utils.{aws,ssm,s3}`	EC2/ECS instance metadata, SSM parameter fetch, S3 upload/download (`[aws]`)
`neutronium.utils.{print,params,profiling,memory,url_credentials}`	Assorted small utilities
`neutronium.threads.thread_simple`	Minimal threading helpers
`neutronium.telemetry`	Request-context vars, `RequestFacts`, pluggable sinks
`neutronium.logging`	JSON / dev-console log formatters and context filters

Optional extras

text, time, aws, url, requests, memory, memory-extended, xpath, otel, profiling — install only what you use.

aws → boto3, requests, ec2-metadata (for neutronium.utils.aws / ssm / s3)
url → tldextract (only for get_url_domain; the rest of neutronium.utils.url is pure stdlib)
memory → psutil (for print_memory_usage); memory-extended → pympler, objgraph (for the heap/objgraph tools — opt in only if you use them)

Development

uv run --all-extras pytest   # installs all optional extras + the dev group

License

MIT © Gaussian Holdings, LLC

Release files for neutronium 0.3.1

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

Source distribution (sdist)

Source distribution for neutronium 0.3.1
File	Size	Uploaded
neutronium-0.3.1.tar.gz	55.2 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for neutronium 0.3.1
File	Interpreter	ABI	Platform	Reset
neutronium-0.3.1-py3-none-any.whl 53.1 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 108.3 kB

Release files / neutronium-0.3.1.tar.gz

Download URL	neutronium-0.3.1.tar.gz
Size	55.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`f9810d2f0f388d603d5dd44461e36e96de64342f8827f424bdd1f988d57c9519`
BLAKE2b-256 checksum How to use checksums	`f47085df930867f482b52466146db2450b547683ff86e01cce51313c4af1c9a5`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/gaussian/neutronium
Publishing commit: github.com/gaussian/neutronium/tree/a461db81aa08f762b558cb2b23ea20dbb386b82d

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/a461db81aa08f762b558cb2b23ea20dbb386b82d/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/35261981873/attempts/1

Artifact

Subject: neutronium-0.3.1.tar.gz
SHA-256 checksum: f9810d2f0f388d603d5dd44461e36e96de64342f8827f424bdd1f988d57c9519 Verifying attestations

Release files / neutronium-0.3.1-py3-none-any.whl

Download URL	neutronium-0.3.1-py3-none-any.whl
Size	53.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1a8d7ab4447b6feb5b0316c35c94c9569dc2180cfbbd4aaf7f58944bec5fff8e`
BLAKE2b-256 checksum How to use checksums	`d09f2558bbeaad49c0d886492dc93e1e6ebb104c8eddd0c0db6b8e6c410c2239`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/gaussian/neutronium
Publishing commit: github.com/gaussian/neutronium/tree/a461db81aa08f762b558cb2b23ea20dbb386b82d

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/a461db81aa08f762b558cb2b23ea20dbb386b82d/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/35261981873/attempts/1

Artifact

Subject: neutronium-0.3.1-py3-none-any.whl
SHA-256 checksum: 1a8d7ab4447b6feb5b0316c35c94c9569dc2180cfbbd4aaf7f58944bec5fff8e Verifying attestations