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.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 neutronium 0.2.5
File	Size	Uploaded
neutronium-0.2.5.tar.gz	55.0 kB	Jul 30, 2026	Details

Built distribution (wheel)

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

Total release size: 107.8 kB

Release files / neutronium-0.2.5.tar.gz

Download URL	neutronium-0.2.5.tar.gz
Size	55.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`de3d7ca953238afd416f999626d1d74ff38272a1ad056240f19725a26f5bef89`
BLAKE2b-256 checksum How to use checksums	`0091007e05029c786d39117a51042022df987bd6b5e9b3e958aa2ad889003af6`
Upload date	Jul 30, 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/4433ee620acf48b52c71f5c18c0e1b0d2ffe4219

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/4433ee620acf48b52c71f5c18c0e1b0d2ffe4219/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/30566768212/attempts/1

Artifact

Subject: neutronium-0.2.5.tar.gz
SHA-256 checksum: de3d7ca953238afd416f999626d1d74ff38272a1ad056240f19725a26f5bef89 Verifying attestations

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

Download URL	neutronium-0.2.5-py3-none-any.whl
Size	52.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0eb489328c19429ccaaffb074ab13c43961448cac7fc93a86fd3e1a80178787a`
BLAKE2b-256 checksum How to use checksums	`ebb76f79c23507d348fc8cf1b7a423283d1bcb2ac0a726e356c507a48e9f1b14`
Upload date	Jul 30, 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/4433ee620acf48b52c71f5c18c0e1b0d2ffe4219

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/4433ee620acf48b52c71f5c18c0e1b0d2ffe4219/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/30566768212/attempts/1

Artifact

Subject: neutronium-0.2.5-py3-none-any.whl
SHA-256 checksum: 0eb489328c19429ccaaffb074ab13c43961448cac7fc93a86fd3e1a80178787a Verifying attestations