Skip to content

The examples split: component-repo demos, showcase aggregator, shared-helpers package (post-program) #116

Description

@bdbarnett

Direction adopted in principle 2026-08-29, deliberately parked until after the modernization program (now complete). Recorded here so it stays visible.

Agreed shape:

  • Single-package demos move into their component repos, inheriting per-repo doc-example CI guards.
  • Integration showcases + the gallery/PyScript harness stay here — pydevices-examples becomes the showcase/aggregator, and its deploy gains an aggregation step pulling component examples in.
  • The shared helpers (tft_config, console, wifi.py, lv_encoder_emu, plus whatever of pydevices' own utils merges in — inventory needed) become their own repo/package, installable whole via mip/pip and per-file via documented raw URLs (mip github single-file paths); each helper must import standalone, CI-checked.

Open decisions for Brad at kickoff:

  1. Repo/package name — unprefixed utils is too generic an import; pdutils was floated.
  2. The pydevices/utils merge inventory.

Sibling philosophy to the audiocomponents split (issue filed on audioif).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions