fix: meta programming experiments

Author: praisetompane

.gitignore

@@ -163,4 +163,6 @@ cython_debug/
 .vscode
 
 ecosystem/
-scratch_pad.py
+scratch_pad.py
+
+What Does It Take To Be An Expert At Python

1_core_language/3_datamodel/1_objects_values_and_types/def.txt

@@ -1,5 +1,13 @@
 What is the Data model?
 
+def data model:
+    a means by which we can implement protocols.
+    the protocol meaning is determined by the specific type.
+    example:
+        - __add__ for a string means concatenate
+        - __add__ for a Polynomial means add the coefficients
+        - ...
+
 1. objects, values and types
     What is?:
         id()

2_standard_library/4_built_in_types/12_context_manager_types/def.txt

@@ -15,8 +15,9 @@ def generator | generator function:
 
   - use cases:
     - process or generate N values without using up N memory. Especially useful when N is large or even greater than all available memory.
-    - Just In Time processing: generate values as they become available and process them at call/client side.
-      
+    - Just In Time processing: generate values as they become available and return them for processing them at call/client side.
+    - create coroutines, which allows interleaving client code with library code:
+      - this enables sequencing
   - proof: None. It is a definition.
 
 References:

2_standard_library/4_built_in_types/5_iterator_types/2_generator.txt

@@ -0,0 +1,35 @@
+
+
+class BaseMeta(type):
+    """
+        objective: Implements solution 3. metaclass.
+        Features:
+            - allows interception of construction of derived classes.
+            - they have various data model methods yo can use.
+
+    """
+
+    def __new__(cls, name, basses, body):
+        # print('Base.__meta__', cls, name, basses, body)
+        if not 'foo' in body:
+            raise TypeError("Missing `foo` method on a subclass")
+        return super().__new__(cls, name, basses, body)
+
+
+class Base(metaclass=BaseMeta):
+    def foo(self):
+        """
+            Observation: user.py code might not implement `foo` and this code will break.
+            Question:
+                1. How do you as a library author ensure that user code implements this?
+                    i.e. Enforce constraints on classes that Derive from Base
+
+
+            """
+        return self.foo()
+
+
+"""
+References:
+    Powell, J. 2017. What Does It Take To Be An Expert At Python. PyData
+"""

4_experiments/1_core_language/3_datamodel/3_3_special_method_names/3_3_3_customizing_class_creation/3_3_3_1_metaclasses/library_code_contraint_enforcement/__build_class__/def.txt

@@ -0,0 +1,21 @@
+from library import Base
+
+
+class Derived(Base):
+    """
+    Observation: Base.foo is not implemented.
+    """
+    """
+    # implementing this will fix the error as expected.
+    def foo(self):
+        return "foo"
+    """
+
+
+if __name__ == "__main__":
+    c = Derived()
+
+"""
+References:
+    Powell, J. 2017. What Does It Take To Be An Expert At Python. PyData
+"""

4_experiments/1_core_language/3_datamodel/3_3_special_method_names/3_3_3_customizing_class_creation/3_3_3_1_metaclasses/library_code_contraint_enforcement/metaclass/library.py

@@ -0,0 +1,38 @@
+two teams:
+    - library: infrastructure code for reuse by other engineers
+    - user: code used to build software for users
+
+issues:    
+    - library code needs to enforce that user code implements the necessary interface
+        solutions:
+            1. Wrap invocation in Exception handling
+                try:
+                    return self.abstract_method()
+                except Exception: print("handle")
+                
+                Assessment: Not Preferred. Only fails at runtime.
+ 
+            2. __build_class__
+                Take advantage of the fact that Python is Protocol Orientated. Use __build_class__
+                    NB: All statements (except 2) in Python are runtime executable.
+                    Example:
+                        1. This runs
+                            for _ in range(10):
+                                class Bar: pass
+                        2. class Test:
+                            for _ range(10):
+                                def foo():
+                                    pass
+                                    
+                Assessment: Not Preferred.
+
+            3. metaclass
+                - example: What Does It Take To Be An Expert At Python/metaclasses/library_code_contraint_enforcement/metaclasses
+
+                Assessment: Preferred.
+
+            4. __init_subclass__
+                Assessment: Preferred.
+
+References:
+    Powell, J. 2017. What Does It Take To Be An Expert At Python. PyData

4_experiments/1_core_language/3_datamodel/3_3_special_method_names/3_3_3_customizing_class_creation/3_3_3_1_metaclasses/library_code_contraint_enforcement/metaclass/user.py

@@ -0,0 +1,10 @@
+class Base():
+    def food(self):
+        "Intentional typo of `foo` as `food"
+        return "foo"
+
+
+"""
+References:
+    Powell, J. 2017. What Does It Take To Be An Expert At Python. PyData
+"""

4_experiments/1_core_language/3_datamodel/3_3_special_method_names/3_3_3_customizing_class_creation/3_3_3_1_metaclasses/library_code_contraint_enforcement/scenarios.txt

@@ -0,0 +1,12 @@
+two teams:
+    - library: infrastructure code for reuse by other engineers
+    - user: code used to build software for users
+
+issues:
+    - user code needs to enforce that library code posses necessary interface
+        solutions:
+            - assert interface with hasattr:
+                example: What Does It Take To Be An Expert At Python/metaclasses/user_code_constraint_enforcement
+
+References:
+    Powell, J. 2017. What Does It Take To Be An Expert At Python. PyData