Merge branch 'master' into 3-12-error-messages

Author: KateFinegan

python-del-statement/README.md

@@ -0,0 +1,3 @@
+# Python's del: Remove References From Scopes and Containers
+
+This folder provides the code examples for the Real Python tutorial [Python's del: Remove References From Scopes and Containers](https://realpython.com/python-del-statement/).

python-del-statement/custom_dict.py

@@ -0,0 +1,4 @@
+class Dict(dict):
+    def __delitem__(self, key) -> None:
+        print(f"Running .__delitem__() to delete {(key, self[key])}")
+        super().__delitem__(key)

python-del-statement/custom_list.py

@@ -0,0 +1,4 @@
+class List(list):
+    def __delitem__(self, index):
+        print(f"Running .__delitem__() to delete {self[index]}")
+        super().__delitem__(index)

python-del-statement/factorial.py

@@ -0,0 +1,27 @@
+class Factorial:
+    def __init__(self, number):
+        self._number = number
+        self._cache = {0: 1, 1: 1}
+        self._factorial = self._calculate_factorial(number)
+        del self._cache
+
+    def _calculate_factorial(self, number):
+        if number in self._cache:
+            return self._cache[number]
+        current_factorial = number * self._calculate_factorial(number - 1)
+        self._cache[number] = current_factorial
+        return current_factorial
+
+    @property
+    def number(self):
+        return self._number
+
+    @property
+    def factorial(self):
+        return self._factorial
+
+    def __str__(self) -> str:
+        return f"{self._number}! = {self._factorial}"
+
+    def __repr__(self):
+        return f"{type(self).__name__}({self._number})"

python-del-statement/non_deletable.py

@@ -0,0 +1,8 @@
+class NonDeletable:
+    def __init__(self, value):
+        self.value = value
+
+    def __delattr__(self, name):
+        raise AttributeError(
+            f"{type(self).__name__} object doesn't support attribute deletion"
+        )

python-del-statement/person.py

@@ -0,0 +1,15 @@
+class Person:
+    def __init__(self, name):
+        self.name = name
+
+    @property
+    def name(self):
+        return self._name
+
+    @name.setter
+    def name(self, value):
+        self._name = str(value).upper()
+
+    @name.deleter
+    def name(self):
+        raise AttributeError("can't delete attribute 'name'")

python-del-statement/sample.py

@@ -0,0 +1,8 @@
+class SampleClass:
+    class_attribute = 0
+
+    def __init__(self, arg):
+        self.instance_attribute = arg
+
+    def method(self):
+        print(self.instance_attribute)

python-maze-solver/README.md

@@ -0,0 +1,33 @@
+# Build a Maze Solver in Python Using Graphs
+
+This is the code for the Real Python tutorial [Build a Maze Solver in Python Using Graphs](https://realpython.com/python-maze-solver/).
+
+## Installation
+
+The code requires Python 3.10 or later and depends on the NetworkX library. You can install the project into an active virtual environment by issuing the following command from the project root folder:
+
+```sh
+(venv) $ python -m pip install .
+```
+
+For development, consider installing the code in editable mode:
+
+```sh
+(venv) $ python -m pip install --editable .
+```
+
+## Running
+
+To run the maze solver, use the `solve` command and provide the path to a maze file:
+
+```sh
+$ solve /path/to/labyrinth.maze
+```
+
+Alternatively, you can use the more explicit yet equivalent command:
+
+```sh
+$ python -m maze_solver /path/to/labyrinth.maze
+```
+
+If the command succeeds, then you should see either a rendered solution in your default web browser or a relevant error message in the console.

python-maze-solver/mazes/impossible.maze

@@ -0,0 +1,38 @@
+# fmt: off
+# flake8: noqa
+from pathlib import Path
+
+from maze_solver.models.border import Border
+from maze_solver.models.maze import Maze
+from maze_solver.models.role import Role
+from maze_solver.models.square import Square
+
+
+def main() -> None:
+    build_maze().dump(Path(__file__).with_suffix(".maze"))
+
+
+def build_maze() -> Maze:
+    return Maze(
+        squares=(
+            Square(0, 0, 0, Border.EMPTY, Role.EXTERIOR),
+            Square(1, 0, 1, Border.TOP | Border.LEFT),
+            Square(2, 0, 2, Border.TOP | Border.BOTTOM),
+            Square(3, 0, 3, Border.TOP | Border.RIGHT),
+            Square(4, 0, 4, Border.BOTTOM | Border.LEFT, Role.EXTERIOR),
+            Square(5, 1, 0, Border.TOP | Border.BOTTOM | Border.RIGHT, Role.EXIT),
+            Square(6, 1, 1, Border.LEFT | Border.RIGHT),
+            Square(7, 1, 2, Border.TOP | Border.BOTTOM | Border.LEFT | Border.RIGHT, Role.WALL),
+            Square(8, 1, 3, Border.LEFT),
+            Square(9, 1, 4, Border.TOP | Border.BOTTOM, Role.ENTRANCE),
+            Square(10, 2, 0, Border.TOP | Border.RIGHT, Role.EXTERIOR),
+            Square(11, 2, 1, Border.BOTTOM | Border.LEFT),
+            Square(12, 2, 2, Border.TOP | Border.BOTTOM),
+            Square(13, 2, 3, Border.BOTTOM | Border.RIGHT),
+            Square(14, 2, 4, Border.TOP | Border.LEFT, Role.EXTERIOR),
+        )
+    )
+
+
+if __name__ == '__main__':
+    main()