Skip to content

v0.40.1 -- tutorial polish

Choose a tag to compare

@padak padak released this 19 Apr 21:07
· 9 commits to main since this release

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) for uv tool install git+https://github.com/padak/juncture-engine and make install for repo-checkout hackers.
  • New L1 section "Under the hood: what DuckDB actually does" -- shows duckdb CLI 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 juncture agent skill -- one-line scaffold in L1, Python-model add in L2, macros + ephemeral refactor in L3, --var parametrization in L4.

New seed generator

examples/tutorial_shop/scripts/generate_data.py

  • Zero third-party deps; uses stdlib random seeded 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 small

Internal: version SSOT

  • pyproject.toml is now the single source of truth for the version string.
  • src/juncture/_version.py resolves __version__ via importlib.metadata.version("juncture") at import time.
  • README and CLAUDE.md drop the hardcoded 0.40.0 label; the Releases page is the canonical place to look up the current tag.
  • Note: after bumping pyproject.toml in a checkout, a fresh make install (or pip install -e .) is required for juncture --version to reflect it -- editable installs cache the build-time metadata.

Full changelog

v0.40.0...v0.40.1