IncludeCPP 3.7.26__py3-none-any.whl → 3.7.28__py3-none-any.whl

includecpp/__init__.py

@@ -2,7 +2,7 @@ from .core.cpp_api import CppApi
 from .core import cssl_bridge as CSSL
 import warnings
 
-__version__ = "3.7.26"
+__version__ = "3.7.28"
 __all__ = ["CppApi", "CSSL"]
 
 # Module-level cache for C++ modules

includecpp/core/cssl/cssl_builtins.py

@@ -205,6 +205,11 @@ class CSSLBuiltins:
         self._functions['isavailable'] = self.builtin_isavailable
         self._functions['instance::exists'] = self.builtin_isavailable  # Alias
 
+        # Python interop functions
+        self._functions['python::pythonize'] = self.builtin_python_pythonize
+        self._functions['python::wrap'] = self.builtin_python_pythonize  # Alias
+        self._functions['python::export'] = self.builtin_python_pythonize  # Alias
+
         # Regex functions
         self._functions['match'] = self.builtin_match
         self._functions['search'] = self.builtin_search
@@ -2445,6 +2450,211 @@ class CSSLBuiltins:
 
         return None
 
+    # ============= Python Interop Functions =============
+
+    def builtin_python_pythonize(self, cssl_instance: Any) -> Any:
+        """Convert a CSSL class instance to a Python-usable object.
+
+        This allows CSSL classes to be returned and used in Python code
+        with proper attribute access and method calls.
+
+        Usage in CSSL:
+            class Greeter {
+                string name;
+
+                Greeter(string n) {
+                    this->name = n;
+                }
+
+                string sayHello() {
+                    return "Hello, " + this->name + "!";
+                }
+
+                void setName(string newName) {
+                    this->name = newName;
+                }
+
+                string getName() {
+                    return this->name;
+                }
+            }
+
+            greeter = new Greeter("World");
+            pyclass = python::pythonize(greeter);
+            parameter.return(pyclass);
+
+        Usage in Python:
+            from includecpp import CSSL
+
+            cssl = CSSL.CsslLang()
+            greeter = cssl.run('''
+                class Greeter { ... }
+                g = new Greeter("World");
+                parameter.return(python::pythonize(g));
+            ''')
+
+            # Now use it like a normal Python object:
+            print(greeter.name)           # "World"
+            print(greeter.sayHello())     # "Hello, World!"
+            greeter.setName("Python")
+            print(greeter.getName())      # "Python"
+
+        Args:
+            cssl_instance: A CSSLInstance object (created via 'new ClassName()')
+
+        Returns:
+            PythonizedCSSLInstance - A Python-friendly wrapper
+        """
+        from .cssl_types import CSSLInstance, CSSLClass
+
+        if cssl_instance is None:
+            return None
+
+        # Already pythonized
+        if isinstance(cssl_instance, PythonizedCSSLInstance):
+            return cssl_instance
+
+        # Must be a CSSLInstance
+        if not isinstance(cssl_instance, CSSLInstance):
+            # If it's a dict, wrap it as a simple object
+            if isinstance(cssl_instance, dict):
+                return PythonizedDict(cssl_instance)
+            # Return as-is for primitives
+            return cssl_instance
+
+        return PythonizedCSSLInstance(cssl_instance, self.runtime)
+
+
+class PythonizedCSSLInstance:
+    """Python wrapper for CSSL class instances.
+
+    Provides Pythonic attribute access and method calling for CSSL objects.
+    """
+
+    def __init__(self, instance: Any, runtime: Any = None):
+        # Use object.__setattr__ to avoid triggering our custom __setattr__
+        object.__setattr__(self, '_cssl_instance', instance)
+        object.__setattr__(self, '_cssl_runtime', runtime)
+        object.__setattr__(self, '_cssl_class_name', instance._class.name if hasattr(instance, '_class') else 'Unknown')
+
+    def __getattr__(self, name: str) -> Any:
+        """Get member or method from CSSL instance."""
+        if name.startswith('_'):
+            raise AttributeError(f"'{self._cssl_class_name}' has no attribute '{name}'")
+
+        instance = object.__getattribute__(self, '_cssl_instance')
+        runtime = object.__getattribute__(self, '_cssl_runtime')
+
+        # Check for member variable first
+        if instance.has_member(name):
+            value = instance.get_member(name)
+            # Recursively pythonize nested CSSL instances
+            from .cssl_types import CSSLInstance
+            if isinstance(value, CSSLInstance):
+                return PythonizedCSSLInstance(value, runtime)
+            return value
+
+        # Check for method
+        method = instance.get_method(name)
+        if method is not None:
+            # Return a callable wrapper for the method
+            return PythonizedMethod(instance, name, method, runtime)
+
+        raise AttributeError(f"'{self._cssl_class_name}' has no attribute '{name}'")
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        """Set member value on CSSL instance."""
+        if name.startswith('_'):
+            object.__setattr__(self, name, value)
+            return
+
+        instance = object.__getattribute__(self, '_cssl_instance')
+        instance.set_member(name, value)
+
+    def __repr__(self) -> str:
+        class_name = object.__getattribute__(self, '_cssl_class_name')
+        instance = object.__getattribute__(self, '_cssl_instance')
+        members = list(instance._members.keys()) if hasattr(instance, '_members') else []
+        return f"<PythonizedCSSL '{class_name}' members={members}>"
+
+    def __dir__(self) -> list:
+        """List available attributes."""
+        instance = object.__getattribute__(self, '_cssl_instance')
+        members = list(instance._members.keys()) if hasattr(instance, '_members') else []
+        methods = list(instance._class.methods.keys()) if hasattr(instance._class, 'methods') else []
+        return members + methods
+
+    def _to_dict(self) -> dict:
+        """Convert to Python dictionary."""
+        instance = object.__getattribute__(self, '_cssl_instance')
+        result = {}
+        for name, value in instance._members.items():
+            from .cssl_types import CSSLInstance
+            if isinstance(value, CSSLInstance):
+                result[name] = PythonizedCSSLInstance(value, None)._to_dict()
+            else:
+                result[name] = value
+        return result
+
+
+class PythonizedMethod:
+    """Wrapper that makes CSSL methods callable from Python."""
+
+    def __init__(self, instance: Any, method_name: str, method_ast: Any, runtime: Any):
+        self._instance = instance
+        self._method_name = method_name
+        self._method_ast = method_ast
+        self._runtime = runtime
+
+    def __call__(self, *args, **kwargs) -> Any:
+        """Call the CSSL method with arguments."""
+        if self._runtime is None:
+            raise RuntimeError(f"Cannot call method '{self._method_name}' - no runtime available")
+
+        # Execute the method through the runtime
+        # Pass the method AST node, not the method name
+        result = self._runtime._call_method(self._instance, self._method_ast, list(args), kwargs)
+
+        # Pythonize the result if it's a CSSL instance
+        from .cssl_types import CSSLInstance
+        if isinstance(result, CSSLInstance):
+            return PythonizedCSSLInstance(result, self._runtime)
+
+        return result
+
+    def __repr__(self) -> str:
+        return f"<method '{self._method_name}' of '{self._instance._class.name}'>"
+
+
+class PythonizedDict:
+    """Simple wrapper for dict objects with attribute access."""
+
+    def __init__(self, data: dict):
+        object.__setattr__(self, '_data', data)
+
+    def __getattr__(self, name: str) -> Any:
+        data = object.__getattribute__(self, '_data')
+        if name in data:
+            value = data[name]
+            if isinstance(value, dict):
+                return PythonizedDict(value)
+            return value
+        raise AttributeError(f"No attribute '{name}'")
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        if name.startswith('_'):
+            object.__setattr__(self, name, value)
+            return
+        data = object.__getattribute__(self, '_data')
+        data[name] = value
+
+    def __repr__(self) -> str:
+        data = object.__getattribute__(self, '_data')
+        return f"<PythonizedDict {data}>"
+
+    def _to_dict(self) -> dict:
+        return object.__getattribute__(self, '_data')
+
 
 # Module-level convenience functions
 _default_builtins: Optional[CSSLBuiltins] = None

includecpp/vscode/cssl/snippets/cssl.snippets.json

@@ -1164,5 +1164,43 @@
             "}"
         ],
         "description": "Function with selectable modifier combinations"
+    },
+    "Python Pythonize": {
+        "prefix": ["python::pythonize", "pythonize"],
+        "body": "python::pythonize(${1:instance})$0",
+        "description": "Convert CSSL class instance to Python-usable object"
+    },
+    "Return Pythonized Class": {
+        "prefix": "returnpython",
+        "body": [
+            "${1:instance} = new ${2:ClassName}(${3:args});",
+            "pyobj = python::pythonize(${1});",
+            "parameter.return(pyobj);"
+        ],
+        "description": "Create class instance and return as Python object"
+    },
+    "Class with Python Export": {
+        "prefix": "pyclass",
+        "body": [
+            "class ${1:ClassName} {",
+            "\t${2:string} ${3:name};",
+            "",
+            "\t${1}(${4:params}) {",
+            "\t\tthis->${3} = ${5:value};",
+            "\t}",
+            "",
+            "\t${6:string} get${3/(.*)/${1:/capitalize}/}() {",
+            "\t\treturn this->${3};",
+            "\t}",
+            "",
+            "\tvoid set${3/(.*)/${1:/capitalize}/}(${2} newValue) {",
+            "\t\tthis->${3} = newValue;",
+            "\t}",
+            "}",
+            "",
+            "${7:obj} = new ${1}(${8:args});",
+            "parameter.return(python::pythonize(${7}));$0"
+        ],
+        "description": "Create a class and export as Python object"
     }
 }

includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json

@@ -319,6 +319,14 @@
                 {
                     "name": "support.function.namespace.combo.cssl",
                     "match": "\\bcombo::(filterdb|blocked|like)\\b"
+                },
+                {
+                    "name": "support.function.namespace.python.cssl",
+                    "match": "\\bpython::(pythonize|wrap|export)\\b"
+                },
+                {
+                    "name": "support.function.namespace.filter.cssl",
+                    "match": "\\bfilter::(register|unregister|list|exists)\\b"
                 }
             ]
         },

{includecpp-3.7.26.dist-info → includecpp-3.7.28.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.7.26
+Version: 3.7.28
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -853,3 +853,55 @@ cssl.run('''
     printl(@version);
 ''')
 ```
+
+## Return CSSL Classes to Python
+
+Use `python::pythonize()` to convert CSSL class instances into Python-usable objects:
+
+```python
+from includecpp import CSSL
+
+cssl = CSSL.CsslLang()
+
+# Create and return a CSSL class as a Python object
+greeter = cssl.run('''
+    class Greeter {
+        string name;
+
+        Greeter(string n) {
+            this->name = n;
+        }
+
+        string sayHello() {
+            return "Hello, " + this->name + "!";
+        }
+
+        void setName(string newName) {
+            this->name = newName;
+        }
+
+        string getName() {
+            return this->name;
+        }
+    }
+
+    instance = new Greeter("World");
+    pyclass = python::pythonize(instance);
+    parameter.return(pyclass);
+''')
+
+# Now use it like a normal Python object!
+print(greeter.name)           # "World"
+print(greeter.sayHello())     # "Hello, World!"
+greeter.setName("Python")
+print(greeter.getName())      # "Python"
+print(greeter.name)           # "Python"
+```
+
+### Aliases
+
+- `python::pythonize(instance)` - Main function
+- `python::wrap(instance)` - Alias
+- `python::export(instance)` - Alias
+
+All three do the same thing: wrap a CSSL class instance for Python use.

{includecpp-3.7.26.dist-info → includecpp-3.7.28.dist-info}/RECORD

@@ -1,4 +1,4 @@
-includecpp/__init__.py,sha256=tg-Rg63h9qYhHvpAknQ6sig3-2vJE121Nt0YcM6jhCo,1673
+includecpp/__init__.py,sha256=pu-NnXVrmFySEIy47R4t7MyCatn3ewzjtaF7d5YDUfc,1673
 includecpp/__init__.pyi,sha256=uSDYlbqd2TinmrdepmE_zvN25jd3Co2cgyPzXgDpopM,7193
 includecpp/__main__.py,sha256=d6QK0PkvUe1ENofpmHRAg3bwNbZr8PiRscfI3-WRfVg,72
 includecpp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -21,7 +21,7 @@ includecpp/core/project_ui.py,sha256=la2EQZKmUkJGuJxnbs09hH1ZhBh9bfndo6okzZsk2dQ
 includecpp/core/settings_ui.py,sha256=B2SlwgdplF2KiBk5UYf2l8Jjifjd0F-FmBP0DPsVCEQ,11798
 includecpp/core/cssl/CSSL_DOCUMENTATION.md,sha256=47sUPO-FMq_8_CrJBZFoFBgSO3gSi5zoB1Xp7oeifho,40773
 includecpp/core/cssl/__init__.py,sha256=scDXRBNK2L6A8qmlpNyaqQj6BFcSfPInBlucdeNfMF0,1975
-includecpp/core/cssl/cssl_builtins.py,sha256=r-FX4WQeKxerkepqodIiwhtL_kxxa4PJym_WyWIwA_s,92290
+includecpp/core/cssl/cssl_builtins.py,sha256=B_ggaV4zE1kejphXmo0-_XKFyxU4BWv_g0j_KzHpLJI,100225
 includecpp/core/cssl/cssl_builtins.pyi,sha256=3ai2V4LyhzPBhAKjRRf0rLVu_bg9ECmTfTkdFKM64iA,127430
 includecpp/core/cssl/cssl_events.py,sha256=nupIcXW_Vjdud7zCU6hdwkQRQ0MujlPM7Tk2u7eDAiY,21013
 includecpp/core/cssl/cssl_modules.py,sha256=cUg0-zdymMnWWTsA_BUrW5dx4R04dHpKcUhm-Wfiwwo,103006
@@ -42,11 +42,11 @@ includecpp/vscode/cssl/language-configuration.json,sha256=61Q00cKI9may5L8YpxMmvf
 includecpp/vscode/cssl/package.json,sha256=Zu2QoTE0OVCCDUHp1hc7kN2NBbFs60bX-LLGMpXz25M,4853
 includecpp/vscode/cssl/images/cssl.png,sha256=BxAGsnfS0ZzzCvqV6Zb1OAJAZpDUoXlR86MsvUGlSZw,510
 includecpp/vscode/cssl/images/cssl_pl.png,sha256=z4WMk7g6YCTbUUbSFk343BO6yi_OmNEVYkRenWGydwM,799
-includecpp/vscode/cssl/snippets/cssl.snippets.json,sha256=4zHOPWNX2_Pk2j2ms84Cx4wv8H089oio371F3vXohXE,36005
-includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json,sha256=XKRLBOHlCqDDnGPvmNHDQPsIMR1UD9PBaJIlgZOiPqM,21173
-includecpp-3.7.26.dist-info/licenses/LICENSE,sha256=fWCsGGsiWZir0UzDd20Hh-3wtRyk1zqUntvtVuAWhvc,1093
-includecpp-3.7.26.dist-info/METADATA,sha256=DcEjed5M_UJAX_YqHNtwFk6MtdMDHHpi91Mqcb_ents,21277
-includecpp-3.7.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-includecpp-3.7.26.dist-info/entry_points.txt,sha256=6A5Mif9gi0139Bf03W5plAb3wnAgbNaEVe1HJoGE-2o,59
-includecpp-3.7.26.dist-info/top_level.txt,sha256=RFUaR1KG-M6mCYwP6w4ydP5Cgc8yNbP78jxGAvyjMa8,11
-includecpp-3.7.26.dist-info/RECORD,,
+includecpp/vscode/cssl/snippets/cssl.snippets.json,sha256=uV3nHJyQ5f7Pr3FzfbQT2VZOEY3AlGs4wrmqe884jm4,37372
+includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json,sha256=ArCRc_G54kiKGh6WEd4CbmR-SX1X9BOcp3Y0hwZcw44,21543
+includecpp-3.7.28.dist-info/licenses/LICENSE,sha256=fWCsGGsiWZir0UzDd20Hh-3wtRyk1zqUntvtVuAWhvc,1093
+includecpp-3.7.28.dist-info/METADATA,sha256=9zrNxfjy1cYZ8rTRrq6pdEX6hROhfS7GSa2D4fwOpvE,22511
+includecpp-3.7.28.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+includecpp-3.7.28.dist-info/entry_points.txt,sha256=6A5Mif9gi0139Bf03W5plAb3wnAgbNaEVe1HJoGE-2o,59
+includecpp-3.7.28.dist-info/top_level.txt,sha256=RFUaR1KG-M6mCYwP6w4ydP5Cgc8yNbP78jxGAvyjMa8,11
+includecpp-3.7.28.dist-info/RECORD,,