OpenAPIDoctor integration dry run #7

Closed
opened 2026-07-09 21:03:53 +00:00 by Mihaela · 1 comment
Mihaela commented 2026-07-09 21:03:53 +00:00 (Migrated from codeberg.org)

Tracks a dry-run integration of PureYAML into OpenAPIDoctor, the downstream consumer that motivated this package (per PureYAML's README: "a Linux-, Windows-, and WebAssembly-compatible replacement for the YAML pieces that currently force packages such as OpenAPIDoctor through C-backed parsers").

Remaining work:

  • Swap OpenAPIDoctor's YAML parsing path to PureYAML behind a flag or branch.
  • Run OpenAPIDoctor's existing test/fixture suite against the swap and record any behavioral gaps.
  • Confirm the Linux/Windows/WASM build wins this package exists for are actually realized once wired into a real consumer.

Reconstructed from PureYAML's README roadmap, which referenced this as issue #52 before the GitHub to Codeberg migration reset issue numbering on this repo.

Part of #8.

Tracks a dry-run integration of PureYAML into OpenAPIDoctor, the downstream consumer that motivated this package (per PureYAML's README: "a Linux-, Windows-, and WebAssembly-compatible replacement for the YAML pieces that currently force packages such as OpenAPIDoctor through C-backed parsers"). Remaining work: - Swap OpenAPIDoctor's YAML parsing path to PureYAML behind a flag or branch. - Run OpenAPIDoctor's existing test/fixture suite against the swap and record any behavioral gaps. - Confirm the Linux/Windows/WASM build wins this package exists for are actually realized once wired into a real consumer. Reconstructed from PureYAML's README roadmap, which referenced this as issue #52 before the GitHub to Codeberg migration reset issue numbering on this repo. Part of #8.
Mihaela commented 2026-07-09 23:07:44 +00:00 (Migrated from codeberg.org)

Done. OpenAPIDoctor already depended on PureYAML, just pinned to the stale codeberg.org/Mihaela/PureYAML.git org at 0.1.4 (four minor versions behind the 0.2.0 libyaml-port conformance engine). Bumped to codeberg.org/NodetteHQ/PureYAML.git at 0.2.0 and ran the dry run:

  • Full test suite passes unchanged: 63 tests, 6 suites, including a 594-file real-world corpus validation.
  • Confirmed via the executable's own link line (not just Package.resolved, which is misleading here) that Yams never compiles into the shipped binary. It only appears in Package.resolved because OpenAPIKit's test targets depend on it, not because OpenAPIDoctor's own code does.

Commit: OpenAPIHQ/OpenAPIDoctor@b0ced7a, pushed to main.

Done. OpenAPIDoctor already depended on PureYAML, just pinned to the stale `codeberg.org/Mihaela/PureYAML.git` org at 0.1.4 (four minor versions behind the 0.2.0 libyaml-port conformance engine). Bumped to `codeberg.org/NodetteHQ/PureYAML.git` at 0.2.0 and ran the dry run: - Full test suite passes unchanged: 63 tests, 6 suites, including a 594-file real-world corpus validation. - Confirmed via the executable's own link line (not just `Package.resolved`, which is misleading here) that Yams never compiles into the shipped binary. It only appears in `Package.resolved` because OpenAPIKit's *test* targets depend on it, not because OpenAPIDoctor's own code does. Commit: OpenAPIHQ/OpenAPIDoctor@b0ced7a, pushed to main.
Sign in to join this conversation.
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: NodetteHQ/PureYAML#7
No description provided.