Source Read v0.1.0

Source Read helps Python callers represent source-read outcomes without confusing an unreadable source with a successful empty result.

What it provides

• SourceRead.ok(...) and SourceRead.unreadable(...) records
• single-consumption assessment of supplied iterables
• a reserved UNKNOWN verdict and exit code 2 for unreadable or disallowed zero-source assessments
• a clear distinction between a readable empty value and no supplied source records
• safe-by-default representations and generic problem summaries
• explicit detailed diagnostics with control-character escaping
• standard-library-only runtime support for Python 3.11 through 3.14

Security and scope

Source Read is a truthfulness helper, not authentication, authorization, source-integrity verification, access control, or policy enforcement. Callers remain responsible for identifying required sources, reporting read failures honestly, and acting on the returned verdict.

The source-release tooling rejects links, reparse points, non-regular files, file-identity changes, and noncanonical ZIP bytes. Independent source review, the supported Python CI matrix, dependency analysis, and CodeQL passed for this release.

Release format

This is a source-only MIT release. The protected annotated v0.1.0 tag points to commit 51ba075b2a956785e45f236db383526979e31922.

No PyPI or other package-registry artifact is published. The attached source-read-0.1.0.zip is the separately validated deterministic source archive with SHA-256:

51b01355e544ebcad7dd9ef933c6c45924987215cc83a755c0ca10e433556e5b

That digest applies to the named attachment, not GitHub's automatically generated Source code archives.

• Release review: #1
• Tag CI: https://github.com/nymrel/source-read/actions/runs/40814314253
• Documentation and source: https://github.com/nymrel/source-read