✨ Implement list parsing from string with separators

[libklein]

Implements feature #554.

This merge request introduces the functionality to parse List[T] options from strings using a specified separator. An example of how this can be utilized is demonstrated below:

def main(number: List[float] = typer.Option([], multiple_separator=",")):
    print(f"The sum is {sum(number)}")

#  Passing --number 1,2,3 outputs 6  
#  Works with --number 1,2 --number 3 as well. Output would be 6 again.

The implementation works by overwriting the process_value function of the click parser, doing string splitting before forwarding the result to click. This ensures full compatibility with the existing features of both Click and Typer. The feature does not allow whitespace only separators to avoid ambiguities.

Feedback is much appreciated!

Open questions:

• Currently, error handling is implemented in the constructor of typer.Option, which delays error detection until the command execution. Should we consider moving this error handling to the OptionInfo constructor to allow for earlier failure detection?
  ToDo:

• Add to doc_src
• Write tests
• Update documentation

[svlandeg]

Hi, thanks for your PR! I'll put this in draft as long as the test suite is failing.

[ivantodorovich]

Thanks 💚

[dylankiss]

This would be great! Much more convenient to pass a large number of elements to an option 💯
Nice job, @libklein. Hope it will be merged soon 🙏

[misse]

I'd love to use this!

[misse]

@libklein would this work for Enum type choices too?

[dylankiss]

@tiangolo Little loving nudge ☝️ 😅

[libklein]

@misse Yes, it is compatible with all of typer's (and click's) features.

[libklein]

Hi @svlandeg,

more than a year has passed since creating the PR. Are there any updates concerning the roadmap?

[svlandeg]

Hi @libklein,

I have updated the PR to adhere to the new documentation format, and it is still awaiting further review by Tiangolo. It has been put on our internal review queue. I'd like everyone to refrain from adding additional pings, as that just creates a longer PR thread and generates a lot of noise in our notifications on our end. Instead, if you'd like this PR to be merged, please add an emoticon on the very first post ☝️, which gives us a good idea on how "popular" the idea/PR is.

I do realise it can be a bit frustrating to have this PR sit here for so long. There's just a lot of working in maintaining several open-source repo's (Typer, FastAPI, SQLModel, ...) and we do our best to keep up. Thanks for your understanding! 🙏

Hi @svlandeg,

more than a year has passed since creating the PR. Are there any updates concerning the roadmap?

[github-actions]

📝 Docs preview

Last commit 9c313dd at: https://de921145.typertiangolo.pages.dev

Modified Pages

• https://de921145.typertiangolo.pages.dev/tutorial/multiple-values/multiple-options/ - (before)