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

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.2.4
File	Size	Uploaded
neutronium-0.2.4.tar.gz	54.6 kB	Jul 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for neutronium 0.2.4
File	Interpreter	ABI	Platform	Reset
neutronium-0.2.4-py3-none-any.whl 52.8 kB Jul 28, 2026	Python 3	none	any	Details

Total release size: 107.4 kB

Release files / neutronium-0.2.4.tar.gz

Download URL	neutronium-0.2.4.tar.gz
Size	54.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`7a88bf431b98919ed62673a0cd0446a83be34076745817a623af7aac3ecce22d`
BLAKE2b-256 checksum How to use checksums	`e809fa67ff0fccb6012f56341533cc39e1d7dd4018951cc1d9e351a94e4b8356`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.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/b87bc69dc499321248b048db55993309b1da816d

Workflow

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

Artifact

Subject: neutronium-0.2.4.tar.gz
SHA-256 checksum: 7a88bf431b98919ed62673a0cd0446a83be34076745817a623af7aac3ecce22d Verifying attestations

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

Download URL	neutronium-0.2.4-py3-none-any.whl
Size	52.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`61ff2fe466d2076c4281aef0923ebfd46c5b81215e9b4877e444b4121d740af2`
BLAKE2b-256 checksum How to use checksums	`171b9ac265344dcaa2f53fe43c8a09dc61e38b49ce10c7cf7834e1a9b75ef4db`
Upload date	Jul 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Identity

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

Workflow

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

Artifact

Subject: neutronium-0.2.4-py3-none-any.whl
SHA-256 checksum: 61ff2fe466d2076c4281aef0923ebfd46c5b81215e9b4877e444b4121d740af2 Verifying attestations