📝 Add documentation for enums created via the functional API

[Torvaney]

This PR updates the documentation to include discussion of enumerating choices with enum.Enums created with the functional API. This is useful when creating choices dynamically, for example logging.

See further discussion of enums and the functional API in #389

[github-actions]

📝 Docs preview for commit e3f2d03 at: https://6283788fce83e3109147d75c--typertiangolo.netlify.app

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (1e43c6b) to head (e3f2d03).
Report is 126 commits behind head on master.

❗ Current head e3f2d03 differs from pull request most recent head 4fe60e7. Consider uploading reports for the commit 4fe60e7 to get more accurate results

Additional details and impacted files

@@             Coverage Diff             @@
##           master      #398      +/-   ##
===========================================
+ Coverage   96.24%   100.00%   +3.75%     
===========================================
  Files         280       252      -28     
  Lines        5942      5287     -655     
===========================================
- Hits         5719      5287     -432     
+ Misses        223         0     -223     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[joaonc]

Looks great! Hope it gets merged soon.

[github-actions]

📝 Docs preview for commit 4fe60e7 at: https://639cea4bf6fa040349687d3f--typertiangolo.netlify.app

[github-actions]

📝 Docs preview for commit 7abe600 at: https://9cea233c.typertiangolo.pages.dev

[github-actions]

📝 Docs preview for commit 4700981 at: https://c89568c3.typertiangolo.pages.dev

[github-actions]

📝 Docs preview for commit b91c009 at: https://52d96a74.typertiangolo.pages.dev

[svlandeg]

Hi! Thanks for this contribution, and apologies for the delay in reviewing.

I agree that this additional section in the documentation could make it more clear for users on how to use "pure" Python Enum's with Typer.

I updated the PR with the latest from master and also included an Annotated version.

It's probably good if Tiangolo has another look at the exact phrasing in the documentation. I'll leave the final decision to merge or not with him.

[github-actions]

📝 Docs preview for commit acdbc27 at: https://c18a51e0.typertiangolo.pages.dev

Modified Pages

• https://c18a51e0.typertiangolo.pages.dev/tutorial/parameter-types/enum/