✨ Enhance command alias handling and display

docs/tutorial/commands/name.md

@@ -54,3 +54,91 @@ def create_user(username: str):
     ...
 ```
 Then the command name will be `create-user`.
+
+## Command Aliases
+
+You can define aliases for commands so users can call them with different names.
+
+### Positional Aliases
+
+Pass additional positional arguments to `@app.command()`:
+
+{* docs_src/commands/name/tutorial002.py hl[6,9] *}
+
+The `list` command can be called with `list` or `ls`:
+
+<div class="termy">
+
+```console
+$ python main.py --help
+
+Usage: main.py [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --install-completion  Install completion for the current shell.
+  --show-completion     Show completion for the current shell, to copy it or customize the installation.
+  --help                Show this message and exit.
+
+Commands:
+  list, ls
+  remove, rm, delete
+
+$ python main.py list
+
+Listing items
+
+$ python main.py ls
+
+Listing items
+
+$ python main.py remove
+
+Removing items
+
+$ python main.py rm
+
+Removing items
+
+$ python main.py delete
+
+Removing items
+```
+
+</div>
+
+### Keyword Aliases
+
+Use the `aliases` parameter:
+
+{* docs_src/commands/name/tutorial002.py hl[9] *}
+
+Positional aliases and the `aliases` parameter can be combined.
+
+### Hidden Aliases
+
+Use `hidden_aliases` for aliases that work but don't appear in help:
+
+{* docs_src/commands/name/tutorial003.py hl[6] *}
+
+<div class="termy">
+
+```console
+$ python main.py --help
+
+Usage: main.py [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --install-completion  Install completion for the current shell.
+  --show-completion     Show completion for the current shell, to copy it or customize the installation.
+  --help                Show this message and exit.
+
+Commands:
+  list, ls
+  remove
+
+$ python main.py secretlist
+
+Listing items
+```
+
+</div>

docs_src/commands/name/tutorial002.py

@@ -0,0 +1,17 @@
+import typer
+
+app = typer.Typer()
+
+
+@app.command("list", "ls")
+def list_items():
+    print("Listing items")
+
+
+@app.command("remove", aliases=["rm", "delete"])
+def remove_items():
+    print("Removing items")
+
+
+if __name__ == "__main__":
+    app()

docs_src/commands/name/tutorial003.py

@@ -0,0 +1,17 @@
+import typer
+
+app = typer.Typer()
+
+
+@app.command("list", "ls", hidden_aliases=["secretlist"])
+def list_items():
+    print("Listing items")
+
+
+@app.command("remove")
+def remove_items():
+    print("Removing items")
+
+
+if __name__ == "__main__":
+    app()