Complete Python 3.10 exercise solutions and quality tooling

.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+'on':
+  push:
+    branches:
+      - master
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
+      - name: Set up uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9
+        with:
+          version: "0.11.32"
+          enable-cache: true
+          python-version: "3.10"
+      - name: Install dependencies
+        run: uv sync --locked --all-groups
+      - name: Check formatting
+        run: uv run ruff format --check .
+      - name: Lint
+        run: uv run ruff check .
+      - name: Run Pyrefly
+        run: uv run pyrefly check
+      - name: Run mypy
+        run: uv run mypy .
+      - name: Run Pyright
+        run: uv run pyright
+
+  tests:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.10"
+          - "3.14"
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
+      - name: Set up uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9
+        with:
+          version: "0.11.32"
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --locked --all-groups
+      - name: Run tests
+        run: uv run pytest

.gitignore

@@ -0,0 +1,14 @@
+.worktrees/
+.DS_Store
+.coverage
+.mypy_cache/
+.pytest_cache/
+.pyrefly_cache/
+.ruff_cache/
+.tox/
+.venv/
+__pycache__/
+build/
+dist/
+*.egg-info/
+*.py[cod]

.python-version

@@ -0,0 +1 @@
+3.10

CH_02_interactive_python/README.rst

@@ -1,8 +1,16 @@
 Chapter 2 - interactive python
 =======================================================================================================================
 
-1. The `rlcompleter` enhancement we created currently only handles dictionaries. Try and extend the code so it supports lists, strings, and tuples as well.
-2. Add colors to the completer (hint: use `colorama` for the coloring).
-3. Instead of manually completing using our own object introspection, try and use the `jedi` library for autocompletion, which does static code analysis.
-4. Try to create a `Hello` `<ipywidget>` so the name of the person can be edited through a notebook without code changes.
-5. Try and create a script that will look for a given pattern through all of your previous ipython sessions.
+1. `Exercise 1 <exercise_01/README.rst>`_: The ``rlcompleter`` enhancement we
+   created currently only handles dictionaries. Try and extend the code so it
+   supports lists, strings, and tuples as well.
+2. `Exercise 2 <exercise_02/README.rst>`_: Add colors to the completer (hint:
+   use ``colorama`` for the coloring).
+3. `Exercise 3 <exercise_03/README.rst>`_: Instead of manually completing using
+   our own object introspection, try and use the ``jedi`` library for
+   autocompletion, which does static code analysis.
+4. `Exercise 4 <exercise_04/README.rst>`_: Try to create a ``Hello``
+   ``<ipywidget>`` so the name of the person can be edited through a notebook
+   without code changes.
+5. `Exercise 5 <exercise_05/README.rst>`_: Try and create a script that will
+   look for a given pattern through all of your previous ipython sessions.

CH_02_interactive_python/exercise_01/README.rst

@@ -0,0 +1,48 @@
+Exercise 1 - safe finite-sequence completion
+============================================
+
+1. The `rlcompleter` enhancement we created currently only handles dictionaries. Try and extend the code so it supports lists, strings, and tuples as well.
+
+Solution
+--------
+
+``Completer`` extends the standard-library ``rlcompleter.Completer`` with safe
+name and item completion. Exact built-in dictionaries produce recursively safe
+literal keys using ``repr``; non-finite numeric keys, keys nested beyond 64
+tuple levels, and keys that exceed interpreter rendering limits are rejected.
+Exact lists, tuples, and strings produce finite integer indices. Prefixes
+filter candidates, and each request inspects at most 25 items. An explicitly
+supplied namespace is shallow-copied once, and both completion paths use that
+snapshot. Name completion includes Python hard keywords and built-ins without
+inspecting namespace values.
+
+Expressions are parsed with ``ast``. Only names, exact ``SimpleNamespace``
+attributes containing safe containers, and exact built-in container subscripts
+whose keys are safe literals are resolved. Calls and all other expression
+forms are rejected, so completion never evaluates arbitrary Python code.
+Importing the module does not register a ``readline`` completer or mutate
+terminal state.
+
+Dependencies
+------------
+
+The solution uses only the Python standard library. The repository's ``dev``
+dependency group supplies pytest and the static-analysis tools.
+
+Run the demonstration:
+
+.. code-block:: console
+
+   uv run python CH_02_interactive_python/exercise_01/solution_00.py
+
+Run the focused tests:
+
+.. code-block:: console
+
+   uv run pytest CH_02_interactive_python/exercise_01/test_solution_00.py
+
+Reference
+---------
+
+The chapter's original dictionary-only implementation is
+`T_02_modifying_autocompletion.py <https://github.com/mastering-python/code_2/blob/a012f6ce3f5bf11f5bf380d1c4e7f743355adb89/CH_02_interactive_python/T_02_modifying_autocompletion.py>`_.

CH_02_interactive_python/exercise_01/__init__.py

@@ -0,0 +1 @@
+"""Exercise 1: safe item completion."""