Python · deterministic data engineering

GetBible v3 publication pipeline

A Python 3.12 build system that converts SWORD module output into a deterministic, validated, checksummed static API.

Active deterministic publication pipeline
Role
Principal pipeline architect and maintainer
Evidence
1 direct public link
  • Python 3.12
  • Bash
  • NDJSON
  • JSON
  • Checksums
  • GitHub Actions

Purpose and value

Why this system exists

The pipeline creates a controlled publication boundary between native source extraction and downstream consumers. It validates framing and contracts, produces deterministic artifacts, and refuses publication when integrity conditions fail.

Engineering role

Principal pipeline architect and maintainer

System structure

Architecture

  1. 01

    Native SWORD extraction is consumed through a line-oriented NDJSON contract.

  2. 02

    Transformation stages normalize content into versioned static API artifacts.

  3. 03

    Validation checks framing, schemas, identifiers, checksums, and publication expectations.

  4. 04

    Build output is deterministic so releases can be compared, reproduced, and audited.

Boundaries

Principal interfaces

GetBibleSWORD NDJSON v1 output
Static API v3 files and indexes
Builder CLI and Bash orchestration
Release and validation workflows

Judgement

Engineering decisions

Use a streaming contract to keep the native and Python responsibilities independently testable.

Fail closed: malformed or incomplete inputs do not become public artifacts.

Preserve stable identifiers and editorial semantics across transformation.

Confidence model

Delivery, validation, and maintenance

  • Framing and schema validation
  • Checksum generation and verification
  • Deterministic output rules
  • Explicit publication gates

Direct sources

Inspect the evidence

Current verified scope

307 attributable commits and 23,507 recorded changed lines in the dated audit; current chapter-editorial schema and native-publication safeguards reviewed in July 2026.

Interpretation boundary

Generated corpus volume is separate from hand-authored source metrics.

Source reviewed to 2026-07-29

Rapid navigation

Go to

navigate Enter open