Enhance code quality, documentation, and type safety with examples

.vscode/settings.json

@@ -3,7 +3,8 @@
     // "python.envFile": "${workspaceFolder}/.env",,
     // Test settings
     "python.testing.pytestEnabled": true,
-    // "python.testing.unittestEnabled": false,
+  // "python.testing.unittestEnabled": false,
     "python.testing.cwd": "${workspaceFolder}/tests",
-    "python.defaultInterpreterPath": "${workspaceFolder}/2025/typescript/lokalise/.venv/bin/python"
-}
+    "python.defaultInterpreterPath": "${workspaceFolder}/2025/typescript/lokalise/.venv/bin/python",
+    "python.analysis.typeCheckingMode": "basic"
+}

2022/async/after-1/iot/service.py

@@ -1,4 +1,4 @@
-import asyncio
+# import asyncio
 import random
 import string
 from typing import Protocol

2022/async/after-2/iot/service.py

@@ -1,7 +1,7 @@
 import asyncio
 import random
 import string
-from typing import Any, Awaitable, Protocol
+from typing import Protocol
 
 from iot.message import Message, MessageType
 

2025/abstraction/abstraction_abc/filters/base.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+from PIL import Image
+
+
+class FilterBase(ABC):
+    @property
+    @abstractmethod
+    def name(self) -> str: ...
+
+    @abstractmethod
+    def apply(self, image: Image.Image) -> Image.Image: ...
+
+    @abstractmethod
+    def configure(self, config: dict[str, Any]) -> None: ...

2025/abstraction/abstraction_abc/filters/grayscale.py

@@ -0,0 +1,24 @@
+from typing import Any
+
+from PIL import Image, ImageOps
+
+from .base import FilterBase
+
+
+class GrayscaleFilter(FilterBase):
+    def __init__(self) -> None:
+        self._intensity: float = 1.0
+
+    @property
+    def name(self) -> str:
+        return "Grayscale"
+
+    def apply(self, image: Image.Image) -> Image.Image:
+        print(f"Applying {self.name} filter with intensity {self._intensity}")
+        grayscale_image = ImageOps.grayscale(image).convert("RGB")
+        if self._intensity < 1.0:
+            return Image.blend(image, grayscale_image, self._intensity)
+        return grayscale_image
+
+    def configure(self, config: dict[str, Any]) -> None:
+        self._intensity = config.get("intensity", self._intensity)

2025/abstraction/abstraction_abc/filters/invert.py

@@ -0,0 +1,22 @@
+from .base import FilterBase
+from PIL import Image, ImageOps
+from typing import Any
+
+class InvertFilter(FilterBase):
+    def __init__(self) -> None:
+        self._enabled: bool = True
+
+    @property
+    def name(self) -> str:
+        return "Invert"
+
+    def apply(self, image: Image.Image) -> Image.Image:
+        if self._enabled:
+            print(f"Applying {self.name} filter")
+            return ImageOps.invert(image.convert("RGB"))
+        else:
+            print(f"{self.name} filter disabled, returning original image")
+            return image
+
+    def configure(self, config: dict[str, Any]) -> None:
+        self._enabled = config.get("enabled", self._enabled)

2025/abstraction/abstraction_abc/main.py

@@ -0,0 +1,19 @@
+from filters.grayscale import GrayscaleFilter
+from filters.invert import InvertFilter
+from process_img import process_img
+
+
+def main() -> None:
+    input_image: str = "../input.jpg"
+
+    grayscale = GrayscaleFilter()
+    grayscale.configure({"intensity": 0.8})
+    process_img(input_image, "output_abc_grayscale.jpg", grayscale)
+
+    invert = InvertFilter()
+    invert.configure({"enabled": True})
+    process_img(input_image, "output_abc_invert.jpg", invert)
+
+
+if __name__ == "__main__":
+    main()

2025/abstraction/abstraction_abc/process_img.py

@@ -0,0 +1,10 @@
+from filters.base import FilterBase
+from PIL import Image
+
+
+def process_img(image_path: str, output_path: str, filter_obj: FilterBase) -> None:
+    print(f"\nUsing filter: {filter_obj.name}")
+    image = Image.open(image_path)
+    image = filter_obj.apply(image)
+    image.save(output_path)
+    print(f"Saved processed image to {output_path}")

2025/abstraction/abstraction_callable/filters/grayscale.py

@@ -0,0 +1,9 @@
+from PIL import Image, ImageOps
+
+
+def apply_grayscale(image: Image.Image, intensity: float) -> Image.Image:
+    print(f"Applying grayscale filter with intensity {intensity}")
+    grayscale_image = ImageOps.grayscale(image).convert("RGB")
+    if intensity < 1.0:
+        return Image.blend(image, grayscale_image, intensity)
+    return grayscale_image

2025/abstraction/abstraction_callable/filters/invert.py

@@ -0,0 +1,6 @@
+from PIL import Image, ImageOps
+
+
+def apply_invert(image: Image.Image) -> Image.Image:
+    print("Applying invert filter")
+    return ImageOps.invert(image.convert("RGB"))

2025/abstraction/abstraction_callable/filters/sepia.py

@@ -0,0 +1,18 @@
+from PIL import Image
+
+
+def apply_sepia(image: Image.Image) -> Image.Image:
+    print("Applying sepia filter")
+    sepia_image = image.convert("RGB")
+    width, height = sepia_image.size
+    pixels = sepia_image.load()
+
+    for y in range(height):
+        for x in range(width):
+            r, g, b = pixels[x, y]
+            tr = int(0.393 * r + 0.769 * g + 0.189 * b)
+            tg = int(0.349 * r + 0.686 * g + 0.168 * b)
+            tb = int(0.272 * r + 0.534 * g + 0.131 * b)
+            pixels[x, y] = (min(255, tr), min(255, tg), min(255, tb))
+
+    return sepia_image

2025/abstraction/abstraction_callable/main.py

@@ -0,0 +1,40 @@
+from functools import partial
+
+from filters.grayscale import apply_grayscale
+from filters.invert import apply_invert
+from PIL import Image, ImageOps
+from process_img import ImageFilterFn, process_img
+
+
+def make_grayscale_filter(intensity: float = 1.0) -> ImageFilterFn:
+    def filter_func(image: Image.Image) -> Image.Image:
+        print(f"Applying grayscale filter with intensity {intensity}")
+        # Note: intensity isn't actually used by Pillow here, but it demonstrates config
+        return ImageOps.grayscale(image)
+
+    return filter_func
+
+
+def make_invert_filter(enabled: bool = True) -> ImageFilterFn:
+    def filter_func(image: Image.Image) -> Image.Image:
+        if enabled:
+            print("Applying invert filter")
+            return ImageOps.invert(image.convert("RGB"))
+        else:
+            print("Invert filter disabled, returning original image")
+            return image
+
+    return filter_func
+
+
+def main() -> None:
+    input_image: str = "../input.jpg"
+
+    grayscale_fn = partial(apply_grayscale, intensity=0.6)
+    process_img(input_image, "output_abc_grayscale.jpg", grayscale_fn)
+
+    process_img(input_image, "output_abc_invert.jpg", apply_invert)
+
+
+if __name__ == "__main__":
+    main()

2025/abstraction/abstraction_callable/process_img.py

@@ -0,0 +1,12 @@
+from typing import Callable
+
+from PIL import Image
+
+type ImageFilterFn = Callable[[Image], Image]
+
+
+def process_img(image_path: str, output_path: str, filter_fn: ImageFilterFn) -> None:
+    image = Image.open(image_path)
+    image = filter_fn(image)
+    image.save(output_path)
+    print(f"Saved processed image to {output_path}")

2025/abstraction/abstraction_none/filters/grayscale.py

@@ -0,0 +1,22 @@
+from typing import Any
+
+from PIL import Image, ImageOps
+
+
+class GrayscaleFilter:
+    def __init__(self) -> None:
+        self._intensity: float = 1.0
+
+    @property
+    def name(self) -> str:
+        return "Grayscale"
+
+    def apply(self, image: Image.Image) -> Image.Image:
+        print(f"Applying {self.name} filter with intensity {self._intensity}")
+        grayscale_image = ImageOps.grayscale(image).convert("RGB")
+        if self._intensity < 1.0:
+            return Image.blend(image, grayscale_image, self._intensity)
+        return grayscale_image
+
+    def configure(self, config: dict[str, Any]) -> None:
+        self._intensity = config.get("intensity", self._intensity)

2025/abstraction/abstraction_none/filters/invert.py

@@ -0,0 +1,11 @@
+from PIL import Image, ImageOps
+
+
+class InvertFilter:
+    @property
+    def name(self) -> str:
+        return "Invert"
+
+    def do_invert(self, image: Image.Image) -> Image.Image:
+        print(f"Applying {self.name} filter")
+        return ImageOps.invert(image.convert("RGB"))

2025/abstraction/abstraction_none/main.py

@@ -0,0 +1,18 @@
+from filters.grayscale import GrayscaleFilter
+from filters.invert import InvertFilter
+from process_img import process_img
+
+
+def main() -> None:
+    input_image: str = "../input.jpg"
+
+    grayscale = GrayscaleFilter()
+    grayscale.configure({"intensity": 0.8})
+    process_img(input_image, "output_abc_grayscale.jpg", grayscale)
+
+    invert = InvertFilter()
+    process_img(input_image, "output_abc_invert.jpg", invert)
+
+
+if __name__ == "__main__":
+    main()

2025/abstraction/abstraction_none/process_img.py

@@ -0,0 +1,20 @@
+from typing import Any
+
+from filters.grayscale import GrayscaleFilter
+from filters.invert import InvertFilter
+from PIL import Image
+
+
+def process_img(image_path: str, output_path: str, filter_obj: Any) -> None:
+    print(f"\nUsing filter: {filter_obj.name}")
+    image = Image.open(image_path)
+    if isinstance(filter_obj, GrayscaleFilter):
+        filter_obj.configure({"intensity": 0.8})
+        image = filter_obj.apply(image)
+    elif isinstance(filter_obj, InvertFilter):
+        image = filter_obj.do_invert(image)
+    else:
+        print("Unknown filter type. Skipping configuration.")
+
+    image.save(output_path)
+    print(f"Saved processed image to {output_path}")

2025/abstraction/abstraction_protocol/filters/grayscale.py

@@ -0,0 +1,22 @@
+from typing import Any
+
+from PIL import Image, ImageOps
+
+
+class GrayscaleFilter:
+    def __init__(self) -> None:
+        self._intensity: float = 1.0
+
+    @property
+    def name(self) -> str:
+        return "Grayscale"
+
+    def apply(self, image: Image.Image) -> Image.Image:
+        print(f"Applying {self.name} filter with intensity {self._intensity}")
+        grayscale_image = ImageOps.grayscale(image).convert("RGB")
+        if self._intensity < 1.0:
+            return Image.blend(image, grayscale_image, self._intensity)
+        return grayscale_image
+
+    def configure(self, config: dict[str, Any]) -> None:
+        self._intensity = config.get("intensity", self._intensity)

2025/abstraction/abstraction_protocol/filters/invert.py

@@ -0,0 +1,23 @@
+from typing import Any
+
+from PIL import Image, ImageOps
+
+
+class InvertFilter:
+    def __init__(self) -> None:
+        self._enabled: bool = True
+
+    @property
+    def name(self) -> str:
+        return "Invert"
+
+    def apply(self, image: Image.Image) -> Image.Image:
+        if self._enabled:
+            print(f"Applying {self.name} filter")
+            return ImageOps.invert(image.convert("RGB"))
+        else:
+            print(f"{self.name} filter disabled, returning original image")
+            return image
+
+    def configure(self, config: dict[str, Any]) -> None:
+        self._enabled = config.get("enabled", self._enabled)

2025/abstraction/abstraction_protocol/main.py

@@ -0,0 +1,18 @@
+from filters.grayscale import GrayscaleFilter
+from filters.invert import InvertFilter
+from process_img import process_img
+
+
+def main() -> None:
+    input_image: str = "../input.jpg"
+
+    grayscale = GrayscaleFilter()
+    grayscale.configure({"intensity": 0.8})
+    process_img(input_image, "output_abc_grayscale.jpg", grayscale)
+
+    invert = InvertFilter()
+    process_img(input_image, "output_abc_invert.jpg", invert)
+
+
+if __name__ == "__main__":
+    main()

2025/abstraction/abstraction_protocol/process_img.py

@@ -0,0 +1,20 @@
+from typing import Any, Protocol
+
+from PIL import Image
+
+
+class FilterBase(Protocol):
+    @property
+    def name(self) -> str: ...
+
+    def apply(self, image: Image.Image) -> Image.Image: ...
+
+    def configure(self, config: dict[str, Any]) -> None: ...
+
+
+def process_img(image_path: str, output_path: str, filter_obj: FilterBase) -> None:
+    print(f"\nUsing filter: {filter_obj.name}")
+    image = Image.open(image_path)
+    image = filter_obj.apply(image)
+    image.save(output_path)
+    print(f"Saved processed image to {output_path}")

2025/abstraction/pyproject.toml

@@ -0,0 +1,7 @@
+[project]
+name = "abstraction"
+version = "0.1.0"
+requires-python = ">=3.13"
+dependencies = [
+    "pillow>=11.2.1",
+]