You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by "bugraoz93 (via GitHub)" <gi...@apache.org> on 2025/10/31 16:03:34 UTC
[I] Improve Help Texts in airflowctl [airflow]
bugraoz93 opened a new issue, #57632:
URL: https://github.com/apache/airflow/issues/57632
### Description
The current help texts are auto-generated. We need a YAML, JSON-based approach to map these help texts easily, and while onboarding new commands, we can easily update them.
Bonus: Include pre-commit checking the fact that a new command is added, but no help text is there.
### Use case/motivation
https://lists.apache.org/thread/cnz3k2pox69ddkk647mt8gpfy0t70f94
### Related issues
_No response_
### Are you willing to submit a PR?
- [x] Yes I am willing to submit a PR!
### Code of Conduct
- [x] I agree to follow this project's [Code of Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "bugraoz93 (via GitHub)" <gi...@apache.org>.
bugraoz93 commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3476439706
This way, anyone includes a new operation needs to fill help text from these files and will fail pre-commit otherwise
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "bugraoz93 (via GitHub)" <gi...@apache.org>.
bugraoz93 closed issue #57632: Improve Help Texts in airflowctl
URL: https://github.com/apache/airflow/issues/57632
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "Prab-27 (via GitHub)" <gi...@apache.org>.
Prab-27 commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3476391596
@bugraoz93 , I’d like to work on this and test the `airflowctl dags pause/unpause` command to make sure it behaves as expected.
If you’ve already started working on it or plan to pick it up soon—and we’re not running late—
I’m happy to choose another airflowctl issue instead. Just let me know what works best!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3476571822
Nice!
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3986429039
@Prab-27 We are unassigning you from this issue as part of our updated [assignment policy](https://github.com/apache/airflow/blob/main/contributing-docs/04_how_to_contribute.rst#contribute-code-changes).
This is not meant to discourage your contribution — quite the opposite! You are still very welcome to work on this issue and submit a PR for it. Simply comment that you are working on it and open a PR when ready.
We found that formal assignments were not working well, as they often prevented others from contributing when the assignee was not actively working on the issue.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "Prab-27 (via GitHub)" <gi...@apache.org>.
Prab-27 commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3988002633
Will work on this
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "bugraoz93 (via GitHub)" <gi...@apache.org>.
bugraoz93 commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3476439239
Thanks @Prab-27! I will take care of #57630 and #57629 to speed up the release of initial versions. Thanks a lot for asking!
This one can be included in later releases, after discussion in the voting attached to this issue, so I would be happy for you to take this one. My idea, while writing this file-based approach, has a couple of advantages. Open to different ideas for sure. The idea is to make it
* single source of truth
* easy to validate in the pre-commit using `get_parser()` from `cli_parser.py`, where it gives the entire commands included into airflowctl
* easier integration into auto-generation since we are building the `parser` and these are mainly impacting auto-generated ones, since we are writing specific help text for those custom-built ones
So the YAML/JSON could look like, which should be only used for auto-generated from the operation method implemented. This would mean auth won't be included since it is a custom-created under `commands/`
```YAML
assets:
- create-event: "Creat an event for a given Asset ID"
- get: "Retrieve an asset for a given Asset ID"
- ....
backfill:
- create: "Create a backfill job for a given Dag ID and date range"
- get: "Retrieve backfill job details for a given backfill ID"
- list: "List all backfill jobs"
- ....
```
```JSON
{
"assets": {
"create-event": "Creates event for a given asset",
"get": "Retrieve an asset for a given asset-id",
"...": "..."
},
"backfill": {
"create": "Create a backfill job for a given Dag id and date range",
"get": "Retrieve backfill job details for a given backfill ID",
"list": "List all backfill jobs",
"...": "..."
}
}
```
Then we will add these instead of generating inside `CommandFactory`
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [I] Improve Help Texts in airflowctl [airflow]
Posted by "Prab-27 (via GitHub)" <gi...@apache.org>.
Prab-27 commented on issue #57632:
URL: https://github.com/apache/airflow/issues/57632#issuecomment-3476393390
If yes, how can I achieve this? I understand the pre-commit part, but I’m a bit unclear about the YAML/JSON-based approach
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org