From 30c8e5f4123e52ac9aab360aac3139957c17bcad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebasti=C3=A1n=20Ram=C3=ADrez?= Date: Thu, 26 Dec 2019 21:20:51 +0100 Subject: [PATCH] :memo: Update README.md from docs/index.md --- README.md | 119 +++++++++++++++++------------------------------------- 1 file changed, 38 insertions(+), 81 deletions(-) diff --git a/README.md b/README.md index ae724a9..b9a05a6 100644 --- a/README.md +++ b/README.md @@ -44,9 +44,13 @@ Typer stands on the shoulders of a giant. Its only internal dependency is +```console +$ pip install typer +---> 100% +Successfully installed typer ``` + ## Example @@ -70,45 +74,33 @@ if __name__ == "__main__": Run your application: -```bash -python main.py -``` +
+```console +// Run your application +$ python main.py -you will get a response like: - -``` +// You get a nice error, you are missing NAME Usage: main.py [OPTIONS] NAME Try "main.py --help" for help. Error: Missing argument "NAME". -``` -Now pass the `NAME` *argument*: +// You get a --help for free +$ python main.py --help -```bash -python main.py Camila -``` - -You will get a response like: - -``` -Hello Camila -``` - -And you automatically get a `--help` command: - -```bash -python main.py --help -``` - -shows: - -``` Usage: main.py [OPTIONS] NAME Options: --help Show this message and exit. + +// Now pass the NAME argument +$ python main.py Camila + +Hello Camila + +// It works! 🎉 ``` +
## Example upgrade @@ -154,15 +146,11 @@ And that will: ### Run the upgraded example -Get the main `--help`: +
+```console +// Check the --help +$ python main.py --help -```bash -python main.py --help -``` - -shows: - -``` Usage: main.py [OPTIONS] COMMAND [ARGS]... Options: @@ -171,80 +159,49 @@ Options: Commands: goodbye hello -``` -You have 2 sub-commands (the 2 functions), `goodbye` and `hello`. +// You have 2 sub-commands (the 2 functions): goodbye and hello -Now get the help for `hello`: +// Now get the --help for hello -```bash -python main.py hello --help -``` +$ python main.py hello --help -shows: - -``` Usage: main.py hello [OPTIONS] NAME Options: --help Show this message and exit. -``` -And now get the help for `goodbye`: +// And now get the --help for goodbye -```bash -python main.py goodbye --help -``` +$ python main.py goodbye --help -shows: - -``` Usage: main.py goodbye [OPTIONS] NAME Options: --formal / --no-formal --help Show this message and exit. -``` -Notice how it automatically creates a `--formal` and `--no-formal` for your `bool` *option*. +// Automatic --formal and --no-formal for the bool option 🎉 ---- +// And if you use it with the hello command -And of course, if you use it, it does what you expect: +$ python main.py hello Camila -```bash -python main.py hello Camila -``` - -shows: - -``` Hello Camila -``` -Then: +// And with the goodbye command -```bash -python main.py goodbye Camila -``` +$ python main.py goodbye Camila -shows: - -``` Bye Camila! -``` -And: +// And with --formal -```bash -python main.py goodbye --formal Camila -``` +$ python main.py goodbye --formal Camila -shows: - -``` Goodbye Ms. Camila. Have a good day. ``` +
### Recap