📝 Update docs to use Typer() more prominently

[svlandeg]

In an attempt to be minimal/clear, the docs have mostly been using typer.run. However for proper applications, we recommend to use Typer() directly, which unlocks much more options. As such, we're updating the docs here. This has the added advantage that it's easier to experiment with given tutorial examples without first having to adjust them to use Typer().

I know reviewing this is horrible. I've taken the time to go through every edit carefully (0% vibe coding ;-)). Mostly, this meant updating the tutorial examples and then updating the highlighted lines in the documentation markdown files. There were some special cases, that I'll highlight as review comments.

[github-actions]

📝 Docs preview

Last commit d71c498 at: https://3a1a855a.typertiangolo.pages.dev

Modified Pages

• https://3a1a855a.typertiangolo.pages.dev/tutorial/app-dir/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/arguments/default/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/arguments/envvar/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/arguments/help/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/arguments/optional/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/commands/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/commands/one-or-multiple/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/exceptions/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/launch/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/multiple-values/arguments-with-multiple-values/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/multiple-values/multiple-options/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/multiple-values/options-with-multiple-values/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/callback-and-context/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/help/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/name/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/password/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/prompt/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/required/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/options/version/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/bool/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/custom-types/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/datetime/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/enum/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/file/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/number/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/path/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/parameter-types/uuid/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/printing/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/progressbar/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/prompt/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/terminating/ - (before)
• https://3a1a855a.typertiangolo.pages.dev/tutorial/typer-app/ - (before)

[svlandeg]

Ok, this should be now in a good state.

Searching through the code base, the only places that still refer to typer.run() are

• the "first steps" part of the tutorial
• docs_src/arguments/optional/tutorial000.py which was created in this PR specifically to gradually build up the complexity in the "Arguments" docs section
• docs_src/testing/app03 which specifically talks about testing code that don't use Typer()

Everything else is now converted to Typer() and all highlighting in the documentation has been updated, including a few fixes of things that weren't exactly right on master (made separate comments about these).

[tiangolo]

This is looking great! 🚀 🎉

Thanks a lot for going through it all! 🙌

I just reviewed everything, it all looks good. I didn't review the highlighted lines, but I know you did.

---

I was thinking about the new page name, what do you think?

[tiangolo]

Amazing, thank you! 🙌