Support Python 3.13 and drop 3.8. (#633)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: tobiasraabe

.github/workflows/main.yml

@@ -39,7 +39,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
-        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/update-plugin-list.yml

@@ -26,7 +26,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: 3.12
 
       - name: Install dependencies
         run: |

.python-version

@@ -1 +1 @@
-3.12.3
+3.12

README.md

@@ -82,7 +82,7 @@ with `task_`. Here is an example.
 from pathlib import Path
 
 from pytask import Product
-from typing_extensions import Annotated
+from typing import Annotated
 
 
 def task_hello_earth(path: Annotated[Path, Product] = Path("hello_earth.txt")):

docs/source/changes.md

@@ -7,6 +7,7 @@ releases are available on [PyPI](https://pypi.org/project/pytask) and
 
 ## 0.5.2 - 2024-09-15
 
+- {pull}`633` adds support for Python 3.13 and drops support for 3.8.
 - {pull}`640` stops the live display when an exception happened during the execution.
 - {pull}`646` adds a `.gitignore` to the `.pytask/` folder to exclude it from version
   control.

docs/source/how_to_guides/the_data_catalog.md

@@ -110,7 +110,7 @@ The task could look like this.
 ```python
 from pathlib import Path
 from pytask import task
-from typing_extensions import Annotated
+from typing import Annotated
 
 from my_project.config import DATA_NAMES
 from my_project.config import MODEL_NAMES

docs/source/how_to_guides/using_task_returns.md

@@ -26,7 +26,7 @@ defines where the return of the function, a string, should be stored.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/using_task_returns_example_1_py38.py
@@ -68,7 +68,7 @@ of the previous interfaces.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/using_task_returns_example_3_py38.py
@@ -103,7 +103,7 @@ mapped to the defined nodes.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/using_task_returns_example_4_py38.py

docs/source/how_to_guides/writing_custom_nodes.md

@@ -42,15 +42,15 @@ The result will be the following task.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/writing_custom_nodes_example_2_py38.py
 ```
 
 ````
 
-````{tab-item} Python 3.8+ & Return
+````{tab-item} Python 3.9 & Return
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/writing_custom_nodes_example_2_py38_return.py
@@ -87,7 +87,7 @@ we arrive at the following class.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/how_to_guides/writing_custom_nodes_example_3_py38.py

docs/source/reference_guides/api.md

@@ -329,7 +329,7 @@ resolution and execution.
 
     >>> from pathlib import Path
     >>> from pytask import Product
-    >>> from typing_extensions import Annotated
+    >>> from typing import Annotated
     >>> def task_example(path: Annotated[Path, Product]) -> None:
     ...     path.write_text("Hello, World!")
 

docs/source/tutorials/defining_dependencies_products.md

@@ -6,8 +6,8 @@ Defining dependencies and products also serves another purpose. By analyzing the
 pytask determines the order to run the tasks.
 
 This tutorial offers you different interfaces. If you are comfortable with type
-annotations or are not afraid to try them, look at the `Python 3.10+` or `3.8+` tabs.
-You find a tutorial on type hints {doc}`here <../type_hints>`.
+annotations or are not afraid to try them, look at the `Python 3.10+` or `3.9` tabs. You
+find a tutorial on type hints {doc}`here <../type_hints>`.
 
 If you want to avoid type annotations for now, look at the tab named `produces`.
 
@@ -60,7 +60,7 @@ task has finished, pytask will check whether the file exists.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/defining_dependencies_products_products_py38.py
@@ -117,7 +117,7 @@ annotation are dependencies of the task.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 To specify that the task relies on the data set `data.pkl`, you can add the path
@@ -169,7 +169,7 @@ are assumed to point to a location relative to the task module.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/defining_dependencies_products_relative_py38.py
@@ -209,7 +209,7 @@ structures if needed.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/defining_dependencies_products_multiple1_py38.py

docs/source/tutorials/repeating_tasks_with_different_inputs.md

@@ -21,7 +21,7 @@ different seeds and output paths as default arguments of the function.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/repeating_tasks_with_different_inputs1_py38.py
@@ -57,7 +57,7 @@ You can also add dependencies to repeated tasks just like with any other task.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/repeating_tasks_with_different_inputs2_py38.py
@@ -117,7 +117,7 @@ For example, the following function is parametrized with tuples.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/repeating_tasks_with_different_inputs3_py38.py
@@ -158,7 +158,7 @@ a unique name for the iteration.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/repeating_tasks_with_different_inputs4_py38.py
@@ -244,7 +244,7 @@ Following these three tips, the parametrization becomes
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/repeating_tasks_with_different_inputs5_py38.py

docs/source/tutorials/using_a_data_catalog.md

@@ -63,7 +63,7 @@ of our tasks. Here we see again the signature of the task function.
 ```
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/defining_dependencies_products_products_py38.py
@@ -107,7 +107,7 @@ Use `data_catalog["data"]` as an default argument to access the
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 Use `data_catalog["data"]` as an default argument to access the
@@ -167,7 +167,7 @@ Following one of the interfaces gives you immediate access to the
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/using_a_data_catalog_3_py38.py
@@ -241,7 +241,7 @@ different node types which is not relevant now.
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 :sync: python38plus
 
 ```{literalinclude} ../../../docs_src/tutorials/using_a_data_catalog_5_py38.py

docs/source/tutorials/write_a_task.md

@@ -62,7 +62,7 @@ If you want to refresh your knowledge about type hints, read
 
 ````
 
-````{tab-item} Python 3.8+
+````{tab-item} Python 3.9
 
 The task accepts the argument `path` that points to the file where the data set will be
 stored. The path is passed to the task via the default value, `BLD / "data.pkl"`. To

docs_src/how_to_guides/bp_structure_of_task_files.py

@@ -1,8 +1,8 @@
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
 from checks import perform_general_checks_on_data
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/how_to_guides/capturing_warnings_1.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/how_to_guides/capturing_warnings_2.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
-from typing_extensions import Annotated
 
 import pytask
 from pytask import Product

docs_src/how_to_guides/migrating_from_scripts_to_pytask_4.py

@@ -1,8 +1,8 @@
 # Content of task_data_management.py
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/how_to_guides/migrating_from_scripts_to_pytask_5.py

@@ -1,8 +1,8 @@
 from pathlib import Path
+from typing import Annotated
 from typing import Optional
 
 import pandas as pd
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/how_to_guides/provisional_products.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 import httpx
-from typing_extensions import Annotated
 
 from pytask import DirectoryNode
 from pytask import Product

docs_src/how_to_guides/provisional_task.py

@@ -1,6 +1,5 @@
 from pathlib import Path
-
-from typing_extensions import Annotated
+from typing import Annotated
 
 from pytask import DirectoryNode
 

docs_src/how_to_guides/provisional_task_generator.py

@@ -1,6 +1,5 @@
 from pathlib import Path
-
-from typing_extensions import Annotated
+from typing import Annotated
 
 from pytask import DirectoryNode
 from pytask import task

docs_src/how_to_guides/using_task_returns_example_1_py38.py

@@ -1,6 +1,5 @@
 from pathlib import Path
-
-from typing_extensions import Annotated
+from typing import Annotated
 
 
 def task_create_file() -> Annotated[str, Path("file.txt")]:

docs_src/how_to_guides/using_task_returns_example_3_py38.py

@@ -1,6 +1,5 @@
 from pathlib import Path
-
-from typing_extensions import Annotated
+from typing import Annotated
 
 
 def task_create_files() -> Annotated[str, (Path("file1.txt"), Path("file2.txt"))]:

docs_src/how_to_guides/using_task_returns_example_4_py38.py

@@ -1,7 +1,6 @@
+from typing import Annotated
 from typing import Any
 
-from typing_extensions import Annotated
-
 from pytask import PythonNode
 
 nodes = [

docs_src/how_to_guides/writing_custom_nodes_example_2_py38.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/how_to_guides/writing_custom_nodes_example_2_py38_return.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 import pandas as pd
-from typing_extensions import Annotated
 
 
 class PickleNode: ...

docs_src/tutorials/defining_dependencies_products_dependencies_py38.py

@@ -1,9 +1,9 @@
 from pathlib import Path
+from typing import Annotated
 
 import matplotlib.pyplot as plt
 import pandas as pd
 from my_project.config import BLD
-from typing_extensions import Annotated
 
 from pytask import Product
 

docs_src/tutorials/defining_dependencies_products_multiple1_produces.py

@@ -1,5 +1,4 @@
 from pathlib import Path
-from typing import Dict
 
 from my_project.config import BLD
 
@@ -9,5 +8,5 @@
 def task_plot_data(
     path_to_data_0: Path = BLD / "data_0.pkl",
     path_to_data_1: Path = BLD / "data_1.pkl",
-    produces: Dict[str, Path] = _PRODUCTS,
+    produces: dict[str, Path] = _PRODUCTS,
 ) -> None: ...

docs_src/tutorials/defining_dependencies_products_multiple1_py38.py

@@ -1,7 +1,7 @@
 from pathlib import Path
+from typing import Annotated
 
 from my_project.config import BLD
-from typing_extensions import Annotated
 
 from pytask import Product