Skip to content

Move the runnable examples to the website - #207

Merged
ccomb merged 2 commits into
mainfrom
examples-to-website
Jul 14, 2026
Merged

Move the runnable examples to the website#207
ccomb merged 2 commits into
mainfrom
examples-to-website

Conversation

@ccomb

@ccomb ccomb commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Why

The pyvolca/examples/ scripts were only useful when run against a live engine with real databases, and they kept drifting: feed_ratio.py still imported volca.analysis, which no longer exists, and the substitution scripts predated the 0.9 wire renames. Their new home is the website, where each example is published as a documented page, kept runnable, and validated against the current engine — https://www.volca.run/examples/.

Final state

  • pyvolca/examples/ is gone (five scripts), and tests/test_examples.py follows the converter script it exercised.
  • The README's See also section points at the examples page instead of the folder.

Full pyvolca suite after removal: 227 passed, 7 skipped (engine-drift tests, no local binary).

ccomb added 2 commits July 14, 2026 18:28
The example scripts (database conversion, ingredient substitution,
feed ratio, classification exploration) now live as documented,
runnable pages at https://www.volca.run/examples/, maintained and
validated against the current engine there. The README's See-also
entry points at that page, and test_examples.py follows the
converter script out of the tree.
@ccomb
ccomb merged commit b09b429 into main Jul 14, 2026
11 checks passed
@ccomb
ccomb deleted the examples-to-website branch July 14, 2026 20:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant