Sample code for: Implementing Interfaces in Python: ABCs and Protocols (#758)

* Sample code for: Implementing Interfaces in Python: ABCs and Protocols

* Sync python-interface materials with tutorial update

- Fix typo in check_protocols.py import (readers_protocols -> readers_protocol).
- Import runtime_checkable in readers_protocol.py so uncommenting the
  decorator doesn't NameError.
- Remove meta_classes.py and check_virtual_classes.py: the metaclass-based
  virtual subclass example was dropped from the updated tutorial in favor
  of typing.Protocol + @runtime_checkable.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Enable @runtime_checkable in readers_protocol.py

Matches the tutorial's final state (highlighted block in the Runtime
Type-Checking Protocol Subtypes section) and silences the F401 ruff
error for the unused runtime_checkable import.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Final QA

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Bartosz Zaczyński <bartosz.zaczynski@gmail.com>

Author: 3 people

python-interface/README.md

@@ -0,0 +1,3 @@
+# Implementing Interfaces in Python: ABCs and Protocols
+
+This folder provides the code examples for the Real Python tutorial [Implementing Interfaces in Python: ABCs and Protocols](https://realpython.com/python-interface/)

python-interface/check_protocols.py

@@ -0,0 +1,11 @@
+from readers_protocol import EmailReader, FileReaderProtocol, PdfReader
+
+
+def read(reader: FileReaderProtocol, path: str) -> str:
+    reader.load_file(path)
+    return reader.extract_text()
+
+
+# Accepted by the type checker
+read(PdfReader(), "/reports/report.pdf")
+read(EmailReader(), "/mail/message.eml")

python-interface/create_readers.py

@@ -0,0 +1,7 @@
+from readers_abc import EmailReader, FileReaderInterface, PdfReader
+
+pdf_reader = PdfReader()
+email_reader = EmailReader()
+
+print(isinstance(PdfReader(), FileReaderInterface))
+print(issubclass(PdfReader, FileReaderInterface))

python-interface/readers.py

@@ -0,0 +1,36 @@
+class PdfReader:
+    """Extract text from a PDF."""
+
+    def load_file(self, path: str) -> None:
+        print(f"Loading PDF from {path}")
+
+    def extract_text(self) -> str:
+        return "Extracted PDF text"
+
+
+class EmailReader:
+    """Extract text from an email."""
+
+    def load_file(self, path: str) -> None:
+        print(f"Loading email from {path}")
+
+    def extract_text(self) -> str:
+        return "Extracted email text"
+
+
+def read(reader, path: str) -> str:
+    reader.load_file(path)
+    return reader.extract_text()
+
+
+print(read(PdfReader(), "/reports/report.pdf"))
+print(read(EmailReader(), "/mail/message.eml"))
+
+# class EmailReader:
+#     """Extract text from an email."""
+#
+#     def load_file(self, path: str) -> None:
+#         print(f"Loading email from {path}")
+#
+#     def extract_email_text(self) -> str:
+#         return "Extracted email text"

python-interface/readers_abc.py

@@ -0,0 +1,37 @@
+from abc import ABC, abstractmethod
+
+
+class FileReaderInterface(ABC):
+    """Interface for file readers."""
+
+    @abstractmethod
+    def load_file(self, path: str) -> None:
+        """Load a file for text extraction."""
+
+    @abstractmethod
+    def extract_text(self) -> str:
+        """Return text extracted from the loaded file."""
+
+
+class PdfReader(FileReaderInterface):
+    """Extract text from a PDF."""
+
+    def load_file(self, path: str) -> None:
+        """Load a PDF file for text extraction."""
+        print(f"Loading PDF from {path}")
+
+    def extract_text(self) -> str:
+        """Return text extracted from the loaded PDF."""
+        return "Extracted PDF text"
+
+
+class EmailReader(FileReaderInterface):
+    """Extract text from an Email."""
+
+    def load_file(self, path: str) -> None:
+        """Load an EML file for text extraction."""
+        print(f"Loading email from {path}")
+
+    def extract_email_text(self) -> str:
+        """Return text extracted from the loaded email."""
+        return "Extracted email text"

python-interface/readers_protocol.py

@@ -0,0 +1,38 @@
+from typing import Protocol, runtime_checkable
+
+
+@runtime_checkable
+class FileReaderProtocol(Protocol):
+    """Protocol for file readers."""
+
+    def load_file(self, path: str) -> None:
+        """Load a file for text extraction."""
+        ...
+
+    def extract_text(self) -> str:
+        """Return text extracted from the loaded file."""
+        ...
+
+
+class PdfReader:
+    """Extract text from a PDF."""
+
+    def load_file(self, path: str) -> None:
+        """Load a PDF file for text extraction."""
+        print(f"Loading PDF from {path}")
+
+    def extract_text(self) -> str:
+        """Return text extracted from the loaded PDF."""
+        return "Extracted PDF text"
+
+
+class EmailReader:
+    """Extract text from an Email."""
+
+    def load_file(self, path: str) -> None:
+        """Load an EML file for text extraction."""
+        print(f"Loading email from {path}")
+
+    def extract_text(self) -> str:
+        """Return text extracted from the loaded email."""
+        return "Extracted email text"

python-interface/registered_subclass.py

@@ -0,0 +1,12 @@
+from virtual_subclass import Double
+
+print(issubclass(float, Double))
+print(isinstance(1.2345, Double))
+
+
+@Double.register
+class Double64:
+    """A 64-bit double-precision floating-point number."""
+
+
+print(issubclass(Double64, Double))

python-interface/virtual_subclass.py

@@ -0,0 +1,8 @@
+from abc import ABC
+
+
+class Double(ABC):
+    """Double precision floating point number."""
+
+
+Double.register(float)