Merge branch 'master' into skip-ahead-with-continue

Author: bzaczynski

.devcontainer/wordcount/devcontainer.json

@@ -0,0 +1,22 @@
+{
+  "name": "wordcount",
+  "image": "mcr.microsoft.com/devcontainers/python:3.13-bookworm",
+  "workspaceFolder": "/workspaces/materials/wordcount",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/materials,type=bind",
+  "postCreateCommand": {
+    "project": "python -m pip install -r requirements.txt -e . && rm -rf src/*.egg-info/",
+    "help": "echo 'echo -e \"💡 Run \\e[1mpytest --task\\e[0m to display instructions for the current task.\n💡 Run \\e[1mpytest\\e[0m to evaluate your solution and track your progress.\"' >> ~/.bashrc"
+  },
+  "customizations": {
+    "codespaces": {
+      "openFiles": [
+        "src/wordcount.py"
+      ]
+    },
+    "vscode": {
+      "extensions": [
+        "ms-python.python"
+      ]
+    }
+  }
+}

debug-python-errors/README.md

@@ -0,0 +1,3 @@
+# How to Debug Common Python Errors
+
+This folder provides the code examples for the Real Python tutorial [How to Debug Common Python Errors](https://realpython.com/debug-python-errors/).

debug-python-errors/cat.py

@@ -0,0 +1,3 @@
+cat = "Siamese"
+
+print(cat)

debug-python-errors/fruit.py

@@ -0,0 +1,12 @@
+def capitalize_fruit_names(fruits):
+    capitalized_fruit_names = []
+    cleaned = [fruit if isinstance(fruit, str) else "" for fruit in fruits]
+
+    for fruit in cleaned:
+        capitalized_fruit_names.append(fruit.capitalize())
+
+    return capitalized_fruit_names
+
+
+if __name__ == "__main__":
+    print(capitalize_fruit_names(["apple", "BANANA", "cherry", "maNgo"]))

debug-python-errors/palindromes.py

@@ -0,0 +1,17 @@
+def find_palindromes(text):
+    # Split sentence into words
+    words = text.split()
+
+    # Remove punctuation and convert to lowercase
+    normalized_words = [
+        "".join(filter(str.isalnum, word)).lower() for word in words
+    ]
+
+    # Check for palindromes
+    return [word for word in normalized_words if word == word[::-1]]
+
+
+if __name__ == "__main__":
+    print(
+        find_palindromes("Dad plays many solos at noon, and sees a racecar.")
+    )

debug-python-errors/test_fruit.py

@@ -0,0 +1,41 @@
+import unittest
+
+from fruit import capitalize_fruit_names
+
+
+class TestFruit(unittest.TestCase):
+    def test_empty_list(self):
+        """with empty list"""
+        self.assertEqual(capitalize_fruit_names([]), [])
+
+    def test_lowercase(self):
+        """with lowercase strings"""
+        self.assertEqual(
+            capitalize_fruit_names(["apple", "banana", "cherry"]),
+            ["Apple", "Banana", "Cherry"],
+        )
+
+    def test_uppercase(self):
+        """with uppercase strings"""
+        self.assertEqual(
+            capitalize_fruit_names(["APPLE", "BANANA", "CHERRY"]),
+            ["Apple", "Banana", "Cherry"],
+        )
+
+    def test_mixed_case(self):
+        """with mixed case strings"""
+        self.assertEqual(
+            capitalize_fruit_names(["mAnGo", "grApE"]),
+            ["Mango", "Grape"],
+        )
+
+    def test_non_string_element(self):
+        """with a mix of integer and string elements"""
+        self.assertEqual(
+            capitalize_fruit_names([123, "banana"]),
+            ["", "Banana"],
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()

loguru/README.md

@@ -0,0 +1,24 @@
+# How to Use Loguru for Simpler Python Logging
+
+This repository contains code related to the Real Python tutorial [How to Use Loguru for Simpler Python Logging](https://realpython.com/python-loguru/).
+
+## Setup
+
+You should first create and activate a virtual environment:
+
+```sh
+$ python -m venv venv/
+$ source venv/bin/activate
+```
+
+Install the pinned dependencies from `requirements.txt`:
+
+```sh
+(venv) $ python -m pip install -r requirements.txt
+```
+
+Then you can execute the provided Python scripts, for example:
+
+```sh
+(venv) $ python basic_logging.py
+```

loguru/basic_logging.py

@@ -0,0 +1,5 @@
+from loguru import logger
+
+logger.debug("Debug message")
+logger.info("Info message")
+logger.error("Error message")

loguru/catch_and_log_errors.py

@@ -0,0 +1,9 @@
+from loguru import logger
+
+
+@logger.catch
+def divide(a, b):
+    return a / b
+
+
+divide(10, 0)

loguru/context_logging.py

@@ -0,0 +1,16 @@
+import sys
+
+from loguru import logger
+
+logger.remove()
+logger.add(sys.stderr, format="{time} | {level} | {message} | {extra}")
+
+user_logger = logger.bind(user_id=123)
+user_logger.info("User logged in")
+user_logger.info("User started a session")
+
+with logger.contextualize(request_id="abc789"):
+    logger.info("Processing request")
+    logger.info("Request completed")
+
+logger.info("Request is processed, this will not show extra context")