Skip to content

A complete and total re-write. #255

Open
daveshanley wants to merge 54 commits intomainfrom
feature-version
Open

A complete and total re-write. #255
daveshanley wants to merge 54 commits intomainfrom
feature-version

Conversation

@daveshanley
Copy link
Copy Markdown
Member

@daveshanley daveshanley commented Apr 9, 2026

openapi-changes was originally built as a tech demo for libopenapi.

It's been pretty successful with that, over a million downloads and lots of use by companies in all kinds of interesting ways.

However, it's always been a horrible codebase, just horrible. I hacked together a system designed to power the online demo I built for it (now retired).

The entire thing has pissed me off, which is why I have not addressed many issues. I felt like I was patching a pile of shit, it was a horrible codebase. One of my engineers who was using it a while back didn't even want to submit features for it. I do not blame him; the code was just horrible. Kind of a patchwork sketch I never finished.

Today I change that.

I have been rebuilding openapi-changes, using all the power from https://doctor.pb33f.io, and significantly upgraded the tool with a much, much more powerful and robust HTML report that genuinely works fully offline.

The entire codebase is brand new, but based on battle tested libraries.

This is a 100% backwards compatible upgrade. You will just notice that everything looks much better and is much richer, much more useful, and has more features.

What you get.

A supercharged, ultra-powerful OpenAPI diffing tool with no other rival.

  • A brand new beautiful terminal UI with the console command. I think it's great.
  • A brand new hyper powerful html-report that contains:
    • A changelog style report of changes
    • A brand new tree navigator
    • New Change Explorer
    • New Diffing Engine
    • New Focused Diff View
    • Change List & Change Items
    • Two new themes
  • A brand new summary command with a much more useful rendering of the change tree
  • All new markdown-report with the same changelog style report generated in the html report, but in markdown
  • Same old report command, but now with a few extra details.
  • License is changing to Apache 2.

What it costs you? Nothing.

It is my gift to the open source community.

timline-explorer change-list change-report explorer-deletion focus-diff roger-mode-items tektronix timeline-overview roger-mode-explorer

delete the one off code.
it’s really nice! I am liking this much more than the previous console experience.
added in markdown report rendering using glamour.
it’s now just a wrapper for the code in the doctor.
looking ropey as hell, but operational
needs a lot of tuning and some new events, but we have done it! the megazoid is coming.
selection, auto path expansion and more.
added lite build to build command.
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.

1 participant