Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tools/importer-rest-api-specs: refactoring the Parser package #4307

Open
wants to merge 50 commits into
base: main
Choose a base branch
from

Conversation

tombuildsstuff
Copy link
Contributor

@tombuildsstuff tombuildsstuff commented Jul 15, 2024

This PR refactors the Parser package into apidefinitions - and removes the old logic/pipeline

Right now this mostly works and requires a few fixes around Discriminators/Supplementary Data that @manicminer is going to pick up

Mostly fixes/rounds out #3754

…e over to using the SDK types/new path

This is a copy and patch up, since I want to leave the existing code path as-is for the moment, to break it apart more effectively
…to the new package

This wants refactoring, but moving it over allows cleaning the rest up
…kage

There's a bunch of these, and whilst these'll get replaced in time with #4017
but for now this cleans this up
…w package

The `parser` package itself needs cleaning, but there's a few things to do first
The rebase is messed up, but it's a minor patch so should be fine
…packages

This leaves the old parser logic in place for now, which'll be cleaned up in the next commit
… command didn't pass the API Definitions Directory correctly
…ch ensures that when we compare the ObjectDefinition from a previously parsed/currently parsed dataset we have matching values

These are normalised post-parsing, so when comparing against the old data set we need to use TitleCase too, so we might as well do this here
…tests

These ensure that the Configs can be parsed and that the Data from them can be loaded
… data test

@manicminer is going to work through fixing this one up, this requires parsing the data identifying any parent types and patching any disciminated implementations across
@tombuildsstuff tombuildsstuff changed the title WIP tools/importer-rest-api-specs: refactoring the Parser package Jul 15, 2024
@manicminer manicminer marked this pull request as ready for review July 19, 2024 00:05
@manicminer manicminer added tool/importer-rest-api-specs Swagger Data Importer issues refactor labels Jul 19, 2024

Where possible we use the terminology `API Definition` since these are implementation details - but this more specific terminology will be used where necessary.

TODO also mention Supplemental Data
Copy link
Member

Choose a reason for hiding this comment

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

@manicminer do you have context on this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
refactor tool/importer-rest-api-specs Swagger Data Importer issues
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants