Repository navigation
v0.40.1 -- tutorial polish
Non-breaking docs + example update on top of v0.40.0. No engine changes; CLI and adapter behaviour are identical.
Tutorial refresh (docs/TUTORIAL.md)
- Install recipe: swapped
pip install juncture(not on PyPI yet) foruv tool install git+https://github.com/padak/juncture-engineandmake installfor repo-checkout hackers. - New L1 section "Under the hood: what DuckDB actually does" -- shows
duckdbCLI usage and spells out that CSV seeds are materialised as TABLE (read_csv_auto) while Parquet seeds are materialised as VIEW (read_parquet). - "With Claude Code" box per Level (L1-L4) with the exact prompt that activates the
junctureagent skill -- one-line scaffold in L1, Python-model add in L2, macros + ephemeral refactor in L3,--varparametrization in L4.
New seed generator
examples/tutorial_shop/scripts/generate_data.py
- Zero third-party deps; uses stdlib
randomseeded from--seed(default 42) so reruns are byte-identical. - Scales:
tiny(8 / 20),small(50 / 200, default),medium(500 / 2000). - Smoke-tested end-to-end through the tutorial_shop DAG (250/250 unit + integration tests pass; 14/14 data tests pass on generated data).
python examples/tutorial_shop/scripts/generate_data.py --scale smallInternal: version SSOT
pyproject.tomlis now the single source of truth for the version string.src/juncture/_version.pyresolves__version__viaimportlib.metadata.version("juncture")at import time.- README and CLAUDE.md drop the hardcoded
0.40.0label; the Releases page is the canonical place to look up the current tag. - Note: after bumping
pyproject.tomlin a checkout, a freshmake install(orpip install -e .) is required forjuncture --versionto reflect it -- editable installs cache the build-time metadata.