✏️ Minor improvements

* Typos
* Wording
* Reformat pyproject.toml files
* Rearrange checks
* Measure times for cache decorator

Author: veit

docs/appendix/checks.rst

@@ -272,12 +272,12 @@ Checks
 
   .. code-block:: pycon
 
-     >>> sheet = {}
-     >>> sheet[("A", 0)] = 1
-     >>> sheet[("A", 1)] = 2
-     >>> sheet[("B", 0)] = 3
-     >>> sheet[("B", 1)] = 4
-     >>> print(sheet[("A", 1)])
+     >>> tabular = {}
+     >>> tabular[("A", 0)] = 1
+     >>> tabular[("A", 1)] = 2
+     >>> tabular[("B", 0)] = 3
+     >>> tabular[("B", 1)] = 4
+     >>> print(tabular[("A", 1)])
      2
 
 * How can you remove all duplicates from a list without changing the order of the
@@ -501,7 +501,7 @@ Checks
      >>> pos
      [0, 1, 2, 3]
 
-* How would you count the total number of negative numbers in the list ``[-[1,
+* How would you count the total number of negative numbers in the list ``[[-1,
   0, 1], [-1, 1, 3], [-2, 0, 2]]``?
 
   .. code-block:: pycon
@@ -621,15 +621,11 @@ Checks
 
   .. code-block:: pycon
 
-     >> def my_func(*params):
-     ...     for i in reversed(params):
-     ...         print(i)
-     ...
-     >>> my_func(1, 2, 3, 4)
-     4
-     3
-     2
-     1
+     >>> values = input("Values separated by commas: ")
+     Values separated by commas: 1,3,2,4
+     >>> value_list = values.split(",")
+     >>> reverse(value_list)
+     ['4', '3', '2', '1']
 
 :doc:`/functions/variables`
 ---------------------------

docs/control-flow/boolean.rst

@@ -31,6 +31,8 @@ considered ``True``.
        4.2
        >>> v
        4.199999999999999
+       >>> round(u, 2) == round(v, 2)
+       True
 
 ``is``, ``is not``, ``in``, ``not in``
     checks the identity:

docs/control-flow/loops.rst

@@ -160,7 +160,7 @@ Checks
 
 * Which list comprehension would you use to achieve the same result?
 
-* How would you count the total number of negative numbers in the list ``[-[1,
+* How would you count the total number of negative numbers in the list ``[[-1,
   0, 1], [-1, 1, 3], [-2, 0, 2]]``?
 
 * Creates a generator that only returns odd numbers from 1 to 10.

docs/explore.rst

@@ -4,28 +4,41 @@ Exploring Python
 Whether you use :ref:`idle` or the :ref:`interactive_shell`, there are some
 useful functions to explore Python.
 
+.. code-block:: pycon
+
+   >>> x = 4.2
+
+``type()``
+----------
+
+With :py:func:`type`, you can display the object type, for example:
+
+.. code-block:: pycon
+
+   >>> type(x)
+   <class 'float'>
+
 .. _help:
 
 ``help()``
 ----------
 
-``help()`` has two different modes. When you type ``help()``, you call the help
-system, which you can use to get information about modules, keywords, and other
-topics. When you are in the help system, you will see a prompt with ``help>``.
-You can now enter a module name, for example ``float``, to search the `Python
-documentation <https://docs.python.org/>`_ for that type.
+:py:func:`help` has two different modes. When you type :func:`help`, you call
+the help system, which you can use to get information about modules, keywords,
+and other topics. When you are in the help system, you will see a prompt with
+``help>``. You can now enter a module name, for example ``float``, to search the
+`Python documentation <https://docs.python.org/>`_ for that type.
 
-``help()`` is part of the :doc:`pydoc <python3:library/pydoc>` library, which
+:func:`help` is part of the :doc:`pydoc <python3:library/pydoc>` library, which
 provides access to the documentation built into Python libraries. Since every
 Python installation comes with full documentation, you have all the
 documentation at your fingertips even offline.
 
-Alternatively, you can use ``help()`` more specifically by passing a type or
+Alternatively, you can use :func:`help` more specifically by passing a type or
 variable name as a parameter, for example:
 
 .. code-block:: pycon
 
-    >>> x = 4.2
     >>> help(x)
     Help on float object:
 
@@ -39,14 +52,27 @@ variable name as a parameter, for example:
      |  __abs__(self, /)
      |      abs(self)
     ...
+    |  is_integer(self, /)
+    |      Return True if the float is an integer.
+    ...
 
 For example, you will learn that ``x`` is of type ``float`` and has a function
-:func:`__add__` that you can use with dot notation:
+ :func:`is_integer` that you can use with dot notation:
+
+.. code-block:: pycon
+
+   >>> x.is_integer()
+   False
+
+``id()``
+--------
+
+:py:func:`id` specifies the identification number of an object, for example:
 
 .. code-block:: pycon
 
-   >>> x.__add__(1)
-   5.2
+   >>> id(x)
+   4304262800
 
 ``dir()``
 ---------

docs/functions/decorators.rst

@@ -78,21 +78,25 @@ as decorators, such as:
     .. code-block:: pycon
        :linenos:
 
-       >>> from functools import cache
-       >>> @cache
+       >>> import timeit
+       ... from functools import cache
+       ... @cache
        ... def factorial(n):
        ...     return n * factorial(n - 1) if n else 1
-       ...
-       >>> factorial(8)
-       40320
-       >>> factorial(10)
-       3628800
-
-    Line 6
-        Since there is no previously stored result, nine recursive calls are
-        made.
-    Line 8
-        makes only two new calls, as the other results come from the cache.
+       ... timeit.timeit("factorial(8)", globals=globals())
+       0.02631620899774134
+
+    Line 1
+        imports the :mod:`timeit` module for measuring execution time.
+    Line 2
+        imports :func:`functools.cache`.
+    Line 5
+        The ``@cache`` decorator is used to store intermediate results, which
+        can then be reused. In our case, the execution speed is increased
+        approximately tenfold.
+    Line 10
+        :func:`timeit.timeit` measures the time of a call. Unless otherwise
+        specified, the call is made one million times.
 
 :func:`functools.wraps`
     This decorator makes the wrapper function look like the original function

docs/functions/params.rst

@@ -24,8 +24,8 @@ Python offers flexible mechanisms for passing :term:`arguments <argument>` to
     ...
     >>> func2(5, w=6)
     45
-    >>> def func3(u, v=1, w=1, *tup):
-    ...     print((u, v, w) + tup)
+    >>> def func3(u, v=1, w=1, *args):
+    ...     print((u, v, w) + args)
     ...
     >>> func3(7)
     (7, 1, 1)

docs/packs/dataprep/pyproject.toml

@@ -1,45 +1,50 @@
 [build-system]
-requires = ["Cython", "setuptools>=77.0"]
 build-backend = "setuptools.build_meta"
+requires = [ "cython", "setuptools>=77" ]
 
 [project]
 name = "dataprep"
 version = "0.1.0"
-authors = [
-  { name="Veit Schiele", email="[email protected]" },
-]
 description = "A small dataprep package"
 readme = "README.rst"
-License-Expression = "BSD-3-Clause"
-License-File = [ "LICENSE" ]
+authors = [
+  { name = "Veit Schiele", email = "[email protected]" },
+]
 requires-python = ">=3.9"
 classifiers = [
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: BSD License",
-    "Operating System :: OS Independent",
+  "License :: OSI Approved :: BSD License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
 ]
 dependencies = [
-    "Cython",
-    "pandas",
+  "cython",
+  "pandas",
 ]
 
+urls."Bug Tracker" = "https://github.com/veit/dataprep/issues"
+urls."Homepage" = "https://github.com/veit/dataprep"
+License-Expression = "BSD-3-Clause"
+License-File = [ "LICENSE" ]
+
 [dependency-groups]
-tests = [
-    "coverage[toml]",
-    "pytest>=6.0",
+dev = [
+  "pre-commit",
+  { include-group = "docs" },
+  { include-group = "tests" },
 ]
 docs = [
-    "furo",
-    "sphinxext-opengraph",
-    "sphinx-copybutton",
-    "sphinx_inline_tabs"
+  "furo",
+  "sphinx-copybutton",
+  "sphinx-inline-tabs",
+  "sphinxext-opengraph",
 ]
-dev = [
-    {include-group = "tests"},
-    {include-group = "docs"},
-    "pre-commit",
+tests = [
+  "coverage[toml]",
+  "pytest>=6",
 ]
-
-[project.urls]
-"Homepage" = "https://github.com/veit/dataprep"
-"Bug Tracker" = "https://github.com/veit/dataprep/issues"

docs/packs/distribution.rst

@@ -238,7 +238,7 @@ as:
 
 .. _license-expression:
 
-``License-Expression``
+``license-expression``
     contains valid `SPDX license expressions
     <https://spdx.github.io/spdx-spec/v2.2.2/SPDX-license-expressions/>`_.
 

docs/packs/myapp/pyproject.toml

@@ -1,17 +1,21 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = [ "hatchling" ]
+
 [project]
 name = "myapp"
 version = "0.1.0"
 description = "Add your description here"
 readme = "README.md"
 authors = [
-    { name = "Veit Schiele", email = "[email protected]" }
+  { name = "Veit Schiele", email = "[email protected]" },
 ]
 requires-python = ">=3.13"
-dependencies = []
-
-[project.scripts]
-myapp = "myapp:main"
+classifiers = [
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+]
+dependencies = [  ]
 
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+scripts.myapp = "myapp:main"

docs/packs/mypack/pyproject.toml

@@ -1,17 +1,21 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = [ "hatchling" ]
+
 [project]
 name = "mypack"
 version = "0.1.0"
 description = "Add your description here"
 readme = "README.md"
 authors = [
-    { name = "Veit Schiele", email = "[email protected]" }
+  { name = "Veit Schiele", email = "[email protected]" },
 ]
 requires-python = ">=3.13"
-dependencies = []
-
-[project.scripts]
-mypack = "mypack:main"
+classifiers = [
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+]
+dependencies = [  ]
 
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+scripts.mypack = "mypack:main"