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

Add --help command line argument #1481

Open
2 of 3 tasks
hawkerm opened this issue Dec 16, 2023 · 3 comments
Open
2 of 3 tasks

Add --help command line argument #1481

hawkerm opened this issue Dec 16, 2023 · 3 comments
Labels
enhancement New feature or request P4 (maybe) Cosmetic bugs, enhancements that may not fit with Twine's scope

Comments

@hawkerm
Copy link

hawkerm commented Dec 16, 2023

Is your feature request related to a problem? Please describe.

There's a few new command line arguments added in 2.8.0, but it's not easy to find their documentation from the release notes, the documentation, the readme, or more importantly the command line itself. i.e. Running:

 Twine.exe --help

Does nothing but run Twine...

It'd be great to have this instead list out the options and brief description of what they do and their parameters like most tools do.

Describe the solution you'd like.

Running Twine on the command line with --help should display help in the terminal on using other arguments to Twine without running twine.

Describe alternatives you've considered.

None

Additional context on this suggestion.

Running on Windows

Presubmission checklist

  • I am interested in working on code that would implement this feature request. (This is not required to submit a suggestion.)
  • I have done a search and believe that an issue does not already exist for this idea in the GitHub repository.
  • I have read and agree to abide by this project's Code of Conduct.
@hawkerm hawkerm added the enhancement New feature or request label Dec 16, 2023
@greyelf
Copy link

greyelf commented Dec 16, 2023

@hawkerm
While I agree it might be nice for the Twine 2.x application to include support for a --help like command option, it isn't unusually for a Graphical User Interface (GUI) based application not to include such, because they aren't Command Line Interface (CLI) based.

eg. The Chrome web-browser (another GUI based app) supports a wide range of command line switches (third-party site), even apparently --help. But if you execute chrome.exe --help in a command shell a Chrome window will be opened, instead of a 'help' like description being displayed in the shell.

@klembot
Copy link
Owner

klembot commented Dec 17, 2023

There's a minor hassle here in that implementing this means we'd have to update documentation in two places (the reference and --help output), but I think it makes sense to do whatever is the norm with GUI apps that take command-line swithces. If there are examples of GUI apps that do show help when run this way, I'm open to implementing this.

@klembot klembot added the P4 (maybe) Cosmetic bugs, enhancements that may not fit with Twine's scope label Dec 17, 2023
@hawkerm
Copy link
Author

hawkerm commented Dec 18, 2023

Visual Studio Code is a counter example and has help on the command line for code --help though if you just type code it launches the GUI app.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request P4 (maybe) Cosmetic bugs, enhancements that may not fit with Twine's scope
Projects
None yet
Development

No branches or pull requests

3 participants