PyJS Examples

This directory is the source tree for the separately installable pyjs-examples distribution. Setuptools maps this directory to the pyjs_examples import package, so the examples remain easy to browse in the repository while installing as an ordinary top-level package.

From the repository root, install the core and examples from a source checkout:

uv sync

An installed PyJS release provides the same package through the examples extra:

python -m pip install "pyjs[examples]"

Run each complete application with the command shown:

List or copy examples using the core scaffolding command:

pyjs template
pyjs template pyjs_examples.calculator
pyjs create my-calculator --template pyjs_examples.calculator
pyjs create --single-file my_counter.py --template pyjs_examples.counter

The distribution registers modules and packages through the pyjs.templates entry-point group. PyJS infers file and directory templates from normal Python module structure instead of hardcoding a catalog.

The focused samples are small, executable sources intended for documentation excerpts and pyjs create PROJECT --template NAME. The initial catalog includes pyjs_examples.samples.state_counter and pyjs_examples.samples.ui_dialog.