Repository navigation
feat: 16 demo projects, one per ecosystem - #19
Merged
Merged
Conversation
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]>
6 of 7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
Every breaking usage carries a comment saying what changed:
3–5 per demo:
axioswerkzeuggolang.org/x/expclapguavarackAutoMappermonologplugdioAlamofireAlamofirelwtfmtspdlogArduinoJsonSimplifications
demo.json. Oneversion string; a replacement will not go stale when a line above it moves.
DEMO.mdis generated from theBREAKINGcomments, so the guide cannotdisagree with the code.
drift.drift,prepares its own demo at creation time only (never on resume), and hides the
other fifteen from the Explorer.
matrix, per-demo patch and expectation files.
check-demos.mjskeeps thecheap 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.driftis on theMarketplace. Nothing here has been exercised in a real Codespace yet, and the
extension install is the part that cannot be until it publishes.