8000 add support for api-data.json file output by gemal · Pull Request #1427 · apidoc/apidoc · GitHub
[go: up one dir, main page]

Skip to content
This repository was archived by the owner on Jun 11, 2024. It is now read-only.

add support for api-data.json file output #1427

Merged
merged 4 commits into from
Aug 9, 2023
Merged

Conversation

gemal
Copy link
Contributor
@gemal gemal commented Aug 8, 2023

fixes #1043
fixes #1390
fixes #1046

Make sure to read the contributing documentation.

IMPORTANT: Base your PR off the 'dev' branch and target that branch for merging.

Would you accept a pull request like this? More work is needed but didn't want to do more if this was not an accepted way forward

@gemal gemal changed the base branch from master to dev August 8, 2023 12:57
@NicolasCARPi
Copy link
Contributor

Hello,

Yes this can be interesting, but I would rather see a boolean flag, and the output is in the assets folder.

@gemal
Copy link
Contributor Author
gemal commented Aug 8, 2023

Can you have a look now?

Copy link
Contributor
@NicolasCARPi NicolasCARPi left a comment

Choose a reason for hiding this comment

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

First, your code doesn't work because of capitalization bug of the option name in writer.js, but that's an easy fix.

Second, I would name the option: --write-json instead. The idea is to remove the terminology "data" which means nothing and is a word that should be avoided.

Finally, it would be important to explain better what it is. Maybe in the help add something like: this will create a file "parsed.json" with the parsed API info collected by the parser and used as source for the generation of the html.

Finally finally, add a test that at least verifies that with this option, a file is created.

gemal added 2 commits August 9, 2023 13:20
something like this?
Still missing test. Which file should I add the test to?
@NicolasCARPi NicolasCARPi merged commit aae6fe9 into apidoc:dev Aug 9, 2023
@NicolasCARPi
Copy link
Contributor

Thank you for your contribution!

@gemal
Copy link
Contributor Author
gemal commented Aug 9, 2023

@NicolasCARPi thanks for good and fast guidance

@gemal
Copy link
Contributor Author
gemal commented Aug 10, 2023

When is the next scheduled release? Eagerly awaiting a release with my fix so I can update :)

@NicolasCARPi
Copy link
Contributor

@gemal There are no schedule. If you want a release you'll need to make a PR that fixes a bug ;) (yeah, I'm blackmailing you!!)

@gemal
Copy link
Contributor Author
gemal commented Aug 10, 2023

I know that this was just a feature but still :)

@gemal
Copy link
Contributor Author
gemal commented Aug 15, 2023

@gemal There are no schedule. If you want a release you'll need to make a PR that fixes a bug ;) (yeah, I'm blackmailing you!!)

not 100% sure I understand? I thought I fixed a bug or did that only qualify as a feature or how does it work?

@NicolasCARPi
Copy link
Contributor

You added a feature, it is not a bugfix in my eyes, it was possible to get the data already, you just made it more convenient. Anyway, I'll make a release now.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

How can I generate api_data.json api_data.json and api_project.json no longer generated apidoc didn't generate the docs anymore, white page
2 participants
0