Establish Python project and development-tooling baseline

JackFrostbyte commented

2026-07-28 23:27:43 -04:00

Owner

Summary

Add a minimal installable Python project using pyproject.toml and a src/arkive/ package layout.
Declare support for Python 3.11 through 3.14 and separate the jsonschema runtime dependency from the Ruff development dependency.
Document the Nobara/Linux development setup, canonical validation commands, offline installation approach, and future CLI entry-point convention.
Add package-import regression coverage and apply the configured Ruff formatter to the existing Python files.

Verification

git diff --check
python pipeline/validate/validate_records.py
python -m unittest discover -s tests -v
Fresh environment setup verified with Python 3.14.6
Editable package installation and import arkive verified
python -m ruff check src pipeline tests
python -m ruff format --check src pipeline tests
python -m pip check

Scope confirmation

No production ingestion or runtime behavior added
No metadata contract changed
No source or generated data added
No unrelated repository-wide reformatting performed
No search, embeddings, LLM, translation, speech, or deployment work added
No placeholder CLI command added

Linked issue

Closes #7

## Summary * Add a minimal installable Python project using `pyproject.toml` and a `src/arkive/` package layout. * Declare support for Python 3.11 through 3.14 and separate the `jsonschema` runtime dependency from the Ruff development dependency. * Document the Nobara/Linux development setup, canonical validation commands, offline installation approach, and future CLI entry-point convention. * Add package-import regression coverage and apply the configured Ruff formatter to the existing Python files. ## Verification * [x] `git diff --check` * [x] `python pipeline/validate/validate_records.py` * [x] `python -m unittest discover -s tests -v` * [x] Fresh environment setup verified with Python 3.14.6 * [x] Editable package installation and `import arkive` verified * [x] `python -m ruff check src pipeline tests` * [x] `python -m ruff format --check src pipeline tests` * [x] `python -m pip check` ## Scope confirmation * [x] No production ingestion or runtime behavior added * [x] No metadata contract changed * [x] No source or generated data added * [x] No unrelated repository-wide reformatting performed * [x] No search, embeddings, LLM, translation, speech, or deployment work added * [x] No placeholder CLI command added ## Linked issue Closes #7

JackFrostbyte added 1 commit

2026-07-28 23:27:43 -04:00