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

[feature request]: automatic markdown documentation generation #180

Open
danielgafni opened this issue Jun 10, 2024 · 5 comments
Open

[feature request]: automatic markdown documentation generation #180

danielgafni opened this issue Jun 10, 2024 · 5 comments
Labels
enhancement New feature or request v3

Comments

@danielgafni
Copy link

A pretty useful feature Typer has is automatic documentation generation. It's really helpful to have this as part of pre-commit hooks and in the CI pipeline.

I wonder if cyclopts could also have this?

@danielgafni danielgafni changed the title Implement automatic markdown documentation generation [feature request]: automatic markdown documentation generation Jun 10, 2024
@BrianPugh BrianPugh added the enhancement New feature or request label Jun 10, 2024
@BrianPugh
Copy link
Owner

I think we can do that! I think a limitation is that the output docs format will have to be the same format as App.help_format. I'll try and get to this!

@doodla
Copy link

doodla commented Jun 25, 2024

@BrianPugh This feature would be very useful to us as we're building out a new CLI app. Were you able to chip away at this?

@BrianPugh
Copy link
Owner

I haven't started this effort yet; I'll begin it after I finish up my dictionary-support efforts.

@danielgafni
Copy link
Author

Hey @BrianPugh, do you need help with this?
I would really like to switch to Cyclopts in my projects, this is the only thing holding me back.
Let me know if I could do anything.

@BrianPugh
Copy link
Owner

Thanks for offering! I'm in the middle of a big refactor that should make this feature pretty easy for a v3.0.0 cyclopts. Still targeting about a month away.

@BrianPugh BrianPugh added the v3 label Sep 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request v3
Projects
None yet
Development

No branches or pull requests

3 participants