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.{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.0

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.0
File	Size	Uploaded
neutronium-0.3.0.tar.gz	54.9 kB	Sep 17, 2026	Details

Built distribution (wheel)

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

Total release size: 107.4 kB

Release files / neutronium-0.3.0.tar.gz

Download URL	neutronium-0.3.0.tar.gz
Size	54.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`88711973847135ef616f746bcc540399b35d34b5e638388a5327435c55f69e37`
BLAKE2b-256 checksum How to use checksums	`f34fc8b374f4b89f3de98798839275559a6cc7e8072f29158c4a1fd38e10fda0`
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/105bb2873ecd1bc1cae8366f95b271b45e1251f7

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/105bb2873ecd1bc1cae8366f95b271b45e1251f7/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/35258378198/attempts/1

Artifact

Subject: neutronium-0.3.0.tar.gz
SHA-256 checksum: 88711973847135ef616f746bcc540399b35d34b5e638388a5327435c55f69e37 Verifying attestations

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

Download URL	neutronium-0.3.0-py3-none-any.whl
Size	52.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`789739a056aa4c6a2744b554bd2d7cb586840b7423996d4743f88b2a505693e4`
BLAKE2b-256 checksum How to use checksums	`92b483486bfc185ea21cfefd788a0f876719f364a15839252eca36ee85f3006d`
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/105bb2873ecd1bc1cae8366f95b271b45e1251f7

Workflow

Publishing configuration: github.com/gaussian/neutronium/blob/105bb2873ecd1bc1cae8366f95b271b45e1251f7/.github/workflows/publish.yml
Publishing logs: github.com/gaussian/neutronium/actions/runs/35258378198/attempts/1

Artifact

Subject: neutronium-0.3.0-py3-none-any.whl
SHA-256 checksum: 789739a056aa4c6a2744b554bd2d7cb586840b7423996d4743f88b2a505693e4 Verifying attestations