Skip to content

feat: 16 demo projects, one per ecosystem - #19

Merged
RodolpheKouyoumdjian merged 1 commit into
mainfrom
feat/simple-demos
Aug 29, 2026
Merged

RodolpheKouyoumdjian merged 1 commit into
mainfrom
feat/simple-demos

Conversation

@RodolpheKouyoumdjian

Copy link
Copy Markdown
Contributor

Rebuilds this as what it should have been: 16 demo projects, one per
ecosystem
, each with several clearly-commented breaking changes, plus a
devcontainer that installs Drift from the Marketplace.

What a demo looks like

Committed at the old version, source written for that old API. Codespace
creation edits only the manifest:

committed:      dependency@OLD  +  source written for OLD
after setup:    dependency@NEW  +  source written for OLD   ← Drift analyses this

Every breaking usage carries a comment saying what changed:

// ── BREAKING 2 ────────────────────────────────────────────────────────────
// `AxiosProxyConfig` used to carry `username` / `password` directly. In
// axios 1.0 those moved into a nested `auth: { username, password }` object,
// so these two properties no longer exist on the type.
export const proxy: AxiosProxyConfig = { ... };

3–5 per demo:

Dependency Upgrade Breaks shown
npm axios 0.21.4 → 1.7.7 3
pypi werkzeug 2.0.3 → 2.1.0 4
go golang.org/x/exp 2023-05 → 2023-10 4
cargo clap 2.34.0 → 4.5.4 5
maven guava 20.0 → 21.0 4
rubygems rack 3.0.0 → 3.1.0 3
nuget AutoMapper 8.1.1 → 9.0.0 5
packagist monolog 2.9.3 → 3.5.0 4
hex plug 1.13.6 → 1.15.0 3
pub dio 4.0.6 → 5.0.0 4
swift Alamofire 4.9.1 → 5.9.1 4
cocoapods Alamofire 4.9.1 → 5.9.1 5
opam lwt 4.5.0 → 5.7.0 3
conan fmt 9.1.0 → 10.2.1 3
vcpkg spdlog 1.11.0 → 1.14.1 3
arduino ArduinoJson 5.13.5 → 6.21.3 5

Simplifications

  • No patch files. The upgrade is a literal find/replace in demo.json. One
    version string; a replacement will not go stale when a line above it moves.
  • DEMO.md is generated from the BREAKING comments, so the guide cannot
    disagree with the code.
  • Devcontainers are generated for all sixteen — each installs drift.drift,
    prepares its own demo at creation time only (never on resume), and hides the
    other fifteen from the Explorer.
  • Removed: the oracle runner, semantic CLI assertions, per-language CI
    matrix, per-demo patch and expectation files. check-demos.mjs keeps the
    cheap part — every demo prepares, dirties only its manifest, and resets —
    and needs no toolchains, so CI is one fast job.

Ready to test

The demos are ready to open in Codespaces as soon as drift.drift is on the
Marketplace. Nothing here has been exercised in a real Codespace yet, and the
extension install is the part that cannot be until it publishes.

Each demo is a small real project pinned to an old version of a real
dependency, with source code that uses APIs the newer version breaks.
Codespace creation edits the manifest to the new version and leaves the
source alone, so Drift has a genuine dependency change to analyse against
code written for the old API.

Every breaking usage carries a BREAKING comment naming the change and why
it no longer works — 3 to 5 per demo:

  npm        axios 0.21.4 → 1.7.7          AxiosTransformer, proxy auth, AxiosError
  pypi       werkzeug 2.0.3 → 2.1.0        safe_str_cmp, pbkdf2_hex, Href, useragents
  go         x/exp 2023-05 → 2023-10       slices comparators bool → int
  cargo      clap 2.34.0 → 4.5.4           App, SubCommand, with_name, takes_value, value_of
  maven      guava 20.0 → 21.0             firstNonNull, toStringHelper, sameThreadExecutor
  rubygems   rack 3.0.0 → 3.1.0            Rack::File, Chunked, Auth::Digest
  nuget      AutoMapper 8.1.1 → 9.0.0      the whole static Mapper API
  packagist  monolog 2.9.3 → 3.5.0         SwiftMailerHandler, int levels → Level enum
  hex        plug 1.13.6 → 1.15.0          Plug.Adapters.* shims
  pub        dio 4.0.6 → 5.0.0             lock/unlock, int timeouts, DioError
  swift      Alamofire 4.9.1 → 5.9.1       SessionManager, responseJSON
  cocoapods  Alamofire 4.9.1 → 5.9.1       same, through a Podfile
  opam       lwt 4.5.0 → 5.7.0             Lwt_sequence, wrap1, add_task_l
  conan      fmt 9.1.0 → 10.2.1            compile-time format strings, join header
  vcpkg      spdlog 1.11.0 → 1.14.1        bundled fmt 10 tightening
  arduino    ArduinoJson 5.13.5 → 6.21.3   StaticJsonBuffer, printTo, parseObject

Devcontainers are generated for all sixteen, each installing the published
drift.drift extension, preparing its own demo at creation time only, and
hiding the other fifteen from the Explorer.

The upgrade is a literal find/replace recorded in demo.json rather than a
patch file — a demo upgrade is one version string, and a replacement does
not go stale when a line above it moves. DEMO.md is generated from the
BREAKING comments so the guide cannot disagree with the code.

Replaces the previous validation-heavy layout: the oracle runner, semantic
CLI assertions and per-language CI matrix are gone, along with the
per-demo patch and expectation files. check-demos.mjs keeps the cheap part
— every demo prepares, dirties only its manifest, and resets — and needs
no toolchains.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Copilot AI lite review requested due to automatic review settings August 29, 2026 15:58

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@RodolpheKouyoumdjian
RodolpheKouyoumdjian merged commit b440c13 into main Aug 29, 2026
1 check passed
@RodolpheKouyoumdjian
RodolpheKouyoumdjian deleted the feat/simple-demos branch August 29, 2026 15:58
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.

2 participants