Merge branch 'master' into feature/CommandAliases

Author: pipinstalled

docs/environment-variables.md

@@ -227,8 +227,6 @@ It could look like this:
 /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin
 ```
 
-This way, when you type `python` in the terminal, the system will find the Python program in `/opt/custompython/bin` (the last directory) and use that one.
-
 ////
 
 //// tab | Windows
@@ -241,8 +239,6 @@ If you say yes to update the `PATH` environment variable, then the installer wil
 C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin
 ```
 
-This way, when you type `python` in the terminal, the system will find the Python program in `C:\opt\custompython\bin` (the last directory) and use that one.
-
 ////
 
 So, if you type:
@@ -257,7 +253,7 @@ $ python
 
 //// tab | Linux, macOS
 
-The system will **find** the `python` program in `/opt/custompython/bin` and run it.
+The system will **find** the `python` program in `/opt/custompython/bin` (the last directory) and run it.
 
 It would be roughly equivalent to typing:
 
@@ -273,7 +269,7 @@ $ /opt/custompython/bin/python
 
 //// tab | Windows
 
-The system will **find** the `python` program in `C:\opt\custompython\bin\python` and run it.
+The system will **find** the `python` program in `C:\opt\custompython\bin\python` (the last directory) and run it.
 
 It would be roughly equivalent to typing:
 

docs/release-notes.md

@@ -2,13 +2,19 @@
 
 ## Latest Changes
 
+### Features
+
+* ✨ Add support for standard tracebacks via the env `TYPER_STANDARD_TRACEBACK`. PR [#1299](https://github.com/fastapi/typer/pull/1299) by [@colin-nolan](https://github.com/colin-nolan).
+
 ### Docs
 
+* 📝 Remove duplicate explanation how the path is resolved. PR [#956](https://github.com/fastapi/typer/pull/956) by [@dennis-rall](https://github.com/dennis-rall).
 * 📝 Update docs to use `Typer()` more prominently. PR [#1418](https://github.com/fastapi/typer/pull/1418) by [@svlandeg](https://github.com/svlandeg).
 * 💄 Use font 'Fira Code' to fix display of Rich panels in docs in Windows. PR [#1419](https://github.com/fastapi/typer/pull/1419) by [@tiangolo](https://github.com/tiangolo).
 
 ### Internal
 
+* ✅ Update tests to use `mod.app` . PR [#1427](https://github.com/fastapi/typer/pull/1427) by [@svlandeg](https://github.com/svlandeg).
 * ⬆ Bump actions/checkout from 5 to 6. PR [#1426](https://github.com/fastapi/typer/pull/1426) by [@dependabot[bot]](https://github.com/apps/dependabot).
 * ⬆ [pre-commit.ci] pre-commit autoupdate. PR [#1425](https://github.com/fastapi/typer/pull/1425) by [@pre-commit-ci[bot]](https://github.com/apps/pre-commit-ci).
 * ⬆ Bump ruff from 0.14.5 to 0.14.6. PR [#1423](https://github.com/fastapi/typer/pull/1423) by [@dependabot[bot]](https://github.com/apps/dependabot).

docs/tutorial/arguments/default.md

@@ -52,7 +52,7 @@ Hello Camila
 
 And we can even make the default value be dynamically generated by passing a function as the `default_factory` argument:
 
-{* docs_src/arguments/default/tutorial002_an.py hl[10:11,14] *}
+{* docs_src/arguments/default/tutorial002_an.py hl[9:10,14] *}
 
 In this case, we created the function `get_name` that will just return a random `str` each time.
 

docs/tutorial/exceptions.md

@@ -235,14 +235,14 @@ TypeError: can only concatenate str (not "int") to str
 
 </div>
 
-You could also achieve the same with the environment variable `_TYPER_STANDARD_TRACEBACK=1`.
+You could also achieve the same with the environment variable `TYPER_STANDARD_TRACEBACK=1` (or by setting the deprecated variable `_TYPER_STANDARD_TRACEBACK=1`).
 
 This will work for any other Typer program too, in case you need to debug a problem in a Typer program made by someone else:
 
 <div class="termy">
 
 ```console
-export _TYPER_STANDARD_TRACEBACK=1
+export TYPER_STANDARD_TRACEBACK=1
 $ python main.py
 
 

docs_src/arguments/default/tutorial002.py

@@ -5,11 +5,11 @@
 app = typer.Typer()
 
 
-@app.command()
 def get_name():
     return random.choice(["Deadpool", "Rick", "Morty", "Hiro"])
 
 
+@app.command()
 def main(name: str = typer.Argument(default_factory=get_name)):
     print(f"Hello {name}")
 

docs_src/arguments/default/tutorial002_an.py

@@ -6,11 +6,11 @@
 app = typer.Typer()
 
 
-@app.command()
 def get_name():
     return random.choice(["Deadpool", "Rick", "Morty", "Hiro"])
 
 
+@app.command()
 def main(name: Annotated[str, typer.Argument(default_factory=get_name)]):
     print(f"Hello {name}")
 

tests/test_completion/test_completion_install.py

@@ -5,16 +5,14 @@
 from unittest import mock
 
 import shellingham
-import typer
 from typer.testing import CliRunner
 
 from docs_src.typer_app import tutorial001 as mod
 
 from ..utils import requires_completion_permission
 
 runner = CliRunner()
-app = typer.Typer()
-app.command()(mod.main)
+app = mod.app
 
 
 @requires_completion_permission

tests/test_completion/test_completion_show.py

@@ -4,14 +4,12 @@
 from unittest import mock
 
 import shellingham
-import typer
 from typer.testing import CliRunner
 
 from docs_src.typer_app import tutorial001 as mod
 
 runner = CliRunner()
-app = typer.Typer()
-app.command()(mod.main)
+app = mod.app
 
 
 def test_completion_show_no_shell():

tests/test_tracebacks.py

@@ -10,7 +10,11 @@ def test_traceback_no_rich():
         [sys.executable, "-m", "coverage", "run", str(file_path)],
         capture_output=True,
         encoding="utf-8",
-        env={**os.environ, "_TYPER_STANDARD_TRACEBACK": ""},
+        env={
+            **os.environ,
+            "TYPER_STANDARD_TRACEBACK": "",
+            "_TYPER_STANDARD_TRACEBACK": "",
+        },
     )
     assert "return get_command(self)(*args, **kwargs)" not in result.stderr
 
@@ -25,7 +29,11 @@ def test_traceback_no_rich_short_disable():
         [sys.executable, "-m", "coverage", "run", str(file_path)],
         capture_output=True,
         encoding="utf-8",
-        env={**os.environ, "_TYPER_STANDARD_TRACEBACK": ""},
+        env={
+            **os.environ,
+            "TYPER_STANDARD_TRACEBACK": "",
+            "_TYPER_STANDARD_TRACEBACK": "",
+        },
     )
     assert "return get_command(self)(*args, **kwargs)" not in result.stderr
 
@@ -40,7 +48,11 @@ def test_unmodified_traceback():
         [sys.executable, "-m", "coverage", "run", str(file_path)],
         capture_output=True,
         encoding="utf-8",
-        env={**os.environ, "_TYPER_STANDARD_TRACEBACK": ""},
+        env={
+            **os.environ,
+            "TYPER_STANDARD_TRACEBACK": "",
+            "_TYPER_STANDARD_TRACEBACK": "",
+        },
     )
     assert "morty" in result.stdout, "the call to the first app should work normally"
     assert "return callback(**use_params)" in result.stderr, (

tests/test_tutorial/test_arguments/test_default/test_tutorial001.py

@@ -1,15 +1,13 @@
 import subprocess
 import sys
 
-import typer
 from typer.testing import CliRunner
 
 from docs_src.arguments.default import tutorial001 as mod
 
 runner = CliRunner()
 
-app = typer.Typer()
-app.command()(mod.main)
+app = mod.app
 
 
 def test_help():