bootprint / bootprint-monorepo Goto Github PK

When installing bootprint-openapi via npm install -g bootprint bootprint-openapi I get the following error:

npm WARN [email protected] requires a peer of bootprint@^2.0.1 but none was installed.

Installing with npm install -g [email protected] bootprint-openapi in turn results in

npm WARN [email protected] requires a peer of bootprint@^4.0.1 but none was installed.
npm WARN [email protected] requires a peer of bootprint@^4.0.1 but none was installed.

I assume the peerDependency from [email protected] to [email protected] is a typo and should instead read [email protected] (since it has been updated just 10 days ago)?

You can skip the global install by doing:

npx -p bootprint-openapi -p bootprint bootprint openapi http://petstore.swagger.io/v2/swagger.json output-folder

That said, npx does not appear to cache any packages if they're specified explicitly at the command line, as above, so the above command does use extra data transfer if you need to run it more than once.

bootprint-openapi is really great and I hope you find enough contributors to maintain it.

I noticed one issue: In OpenAPI 3, the request body parameter is defined using the requestBody field. This seems not to be interpreted by bootprint-openapi though. Can this be (easily) added?

The documentation of the request body field is here:
https://swagger.io/docs/specification/describing-request-body/

Hi love the project!

I'm looking at using it to build Markdown documents based off JSON schemas.

I can create decent markdown documents easy enough using the handle bar templates and a few helpers but I can't find a nice way to do two things.

1. Change the output file name
2. Disable CSS creation.

Based on reading the code it looks like this isn't possible as both engines are created and configured in bootprint itself? Am I reading / not understanding correctly?

Cheers for any help in advance.