IncludeCPP 3.5.0__py3-none-any.whl → 3.7.1__py3-none-any.whl

includecpp/core/cssl_bridge.py

@@ -429,7 +429,7 @@ class CsslLang:
             runtime._inline_payloads = {}
         runtime._inline_payloads[name] = code
 
-    def share(self, instance: Any, name: str) -> str:
+    def share(self, instance: Any, name: str = None) -> str:
         """
         Share a Python object instance with CSSL scripts (LIVE sharing).
 
@@ -437,6 +437,14 @@ class CsslLang:
         will be reflected in the original Python object immediately.
         Call share() again with the same name to update the shared object.
 
+        Args:
+            instance: The Python object to share (or name if using old API)
+            name: The name to reference the object in CSSL ($name)
+
+        Note: Arguments can be passed in either order:
+            cssl.share(my_object, "name")  # Preferred
+            cssl.share("name", my_object)  # Also works
+
         Usage in Python:
             from includecpp import CSSL
             cssl = CSSL.CsslLang()
@@ -474,6 +482,21 @@ class CsslLang:
         global _live_objects
         runtime = self._get_runtime()
 
+        # Handle argument order flexibility: share(instance, name) or share(name, instance)
+        if name is None:
+            # Only one argument - use object type as name
+            name = type(instance).__name__
+        elif isinstance(instance, str) and not isinstance(name, str):
+            # Arguments are swapped: share("name", instance) -> swap them
+            instance, name = name, instance
+        elif not isinstance(name, str):
+            # name is not a string - use its type as name
+            name = type(name).__name__
+
+        # Sanitize filename: remove invalid characters for Windows
+        import re
+        safe_name = re.sub(r'[<>:"/\\|?*\x00-\x1f]', '_', str(name))
+
         # Initialize shared objects registry
         if not hasattr(runtime, '_shared_objects'):
             runtime._shared_objects = {}
@@ -481,7 +504,7 @@ class CsslLang:
         # Generate unique filename: <name>.shareobj<7digits>
         random_suffix = ''.join([str(random.randint(0, 9)) for _ in range(7)])
         share_dir = _get_share_directory()
-        filepath = share_dir / f"{name}.shareobj{random_suffix}"
+        filepath = share_dir / f"{safe_name}.shareobj{random_suffix}"
 
         # Remove old file if updating
         if name in runtime._shared_objects:
@@ -577,22 +600,65 @@ class CsslLang:
 
         return None
 
+    def shared(self, name: str) -> Optional[Any]:
+        """
+        Get a shared object by name (alias for get_shared).
+
+        Returns the actual live object reference, not a copy.
+        Works with both Python cssl.share() and CSSL ==> $name shared objects.
+
+        Usage:
+            from includecpp import CSSL
+            cssl = CSSL.CsslLang()
+
+            # Share an object
+            my_obj = {"value": 42}
+            cssl.share(my_obj, "data")
+
+            # Retrieve it later
+            obj = cssl.shared("data")
+            print(obj["value"])  # 42
+
+        Args:
+            name: Name of the shared object (without $ prefix)
+
+        Returns:
+            The live shared object or None if not found
+        """
+        return self.get_shared(name)
+
 
 # Global shared objects registry (for cross-instance sharing)
 _global_shared_objects: Dict[str, str] = {}
 
 
-def share(instance: Any, name: str) -> str:
+def share(instance: Any, name: str = None) -> str:
     """
     Share a Python object globally for all CSSL instances (LIVE sharing).
 
     Changes made through CSSL will reflect back to the original object.
+
+    Args can be passed in either order:
+        share(my_object, "name")  # Preferred
+        share("name", my_object)  # Also works
     """
     global _live_objects
+    import re
+
+    # Handle argument order flexibility
+    if name is None:
+        name = type(instance).__name__
+    elif isinstance(instance, str) and not isinstance(name, str):
+        instance, name = name, instance
+    elif not isinstance(name, str):
+        name = type(name).__name__
+
+    # Sanitize filename
+    safe_name = re.sub(r'[<>:"/\\|?*\x00-\x1f]', '_', str(name))
 
     random_suffix = ''.join([str(random.randint(0, 9)) for _ in range(7)])
     share_dir = _get_share_directory()
-    filepath = share_dir / f"{name}.shareobj{random_suffix}"
+    filepath = share_dir / f"{safe_name}.shareobj{random_suffix}"
 
     # Remove old file if updating
     if name in _global_shared_objects:
@@ -645,6 +711,32 @@ def get_shared(name: str) -> Optional[Any]:
     return _live_objects.get(name)
 
 
+def shared(name: str) -> Optional[Any]:
+    """
+    Get a shared object by name (alias for get_shared).
+
+    Works with both Python share() and CSSL ==> $name shared objects.
+
+    Usage:
+        from includecpp import CSSL
+
+        # Share an object
+        my_obj = {"value": 42}
+        CSSL.share(my_obj, "data")
+
+        # Retrieve it later
+        obj = CSSL.shared("data")
+        print(obj["value"])  # 42
+
+    Args:
+        name: Name of the shared object (without $ prefix)
+
+    Returns:
+        The live shared object or None if not found
+    """
+    return get_shared(name)
+
+
 # Singleton for convenience
 _default_instance: Optional[CsslLang] = None
 
@@ -783,4 +875,8 @@ __all__ = [
     'clear_output',
     'module',
     'makemodule',
+    'share',
+    'unshare',
+    'shared',
+    'get_shared',
 ]

includecpp/core/cssl_bridge.pyi

@@ -149,6 +149,111 @@ class CsslLang:
         """
         ...
 
+    def share(self, instance: Any, name: str = ...) -> str:
+        """
+        Share a Python object with CSSL (LIVE sharing).
+
+        Changes in CSSL reflect back to Python immediately.
+
+        Args can be passed in either order:
+            cssl.share(my_object, "name")  # Preferred
+            cssl.share("name", my_object)  # Also works
+
+        Usage:
+            class Counter:
+                def __init__(self):
+                    self.value = 0
+
+            counter = Counter()
+            cssl.share(counter, "cnt")
+            cssl.exec('''
+                $cnt.value = $cnt.value + 1;
+            ''')
+            print(counter.value)  # 1
+
+        Args:
+            instance: Python object to share
+            name: Name to reference in CSSL as $name
+
+        Returns:
+            Path to the shared object marker file
+        """
+        ...
+
+    def unshare(self, name: str) -> bool:
+        """
+        Remove a shared object.
+
+        Args:
+            name: Name of the shared object to remove
+
+        Returns:
+            True if removed, False if not found
+        """
+        ...
+
+    def code(self, name: str, code: str) -> None:
+        """
+        Register inline CSSL code as a named payload.
+
+        Usage:
+            cssl.code("helpers", '''
+                void log(string msg) {
+                    printl("[LOG] " + msg);
+                }
+            ''')
+            cssl.exec('''
+                payload("helpers");
+                @log("Hello");
+            ''')
+
+        Args:
+            name: Name for the payload
+            code: CSSL code string
+        """
+        ...
+
+    def get_shared(self, name: str) -> Optional[Any]:
+        """
+        Get a shared object by name (for Python-side access).
+
+        Returns the actual live object reference, not a copy.
+
+        Args:
+            name: Name of the shared object
+
+        Returns:
+            The live shared object or None if not found
+        """
+        ...
+
+    def shared(self, name: str) -> Optional[Any]:
+        """
+        Get a shared object by name (alias for get_shared).
+
+        Returns the actual live object reference, not a copy.
+        Works with both Python cssl.share() and CSSL ==> $name shared objects.
+
+        Usage:
+            from includecpp import CSSL
+            cssl = CSSL.CsslLang()
+
+            # Share an object
+            my_obj = {"value": 42}
+            cssl.share(my_obj, "data")
+
+            # Retrieve it later
+            obj = cssl.shared("data")
+            print(obj["value"])  # 42
+
+        Args:
+            name: Name of the shared object (without $ prefix)
+
+        Returns:
+            The live shared object or None if not found
+        """
+        ...
+
 
 def get_cssl() -> CsslLang:
     """Get default CSSL instance."""
@@ -308,4 +413,76 @@ def makemodule(code: str) -> CSSLFunctionModule:
     ...
 
 
+def share(instance: Any, name: str = ...) -> str:
+    """
+    Share a Python object globally for all CSSL instances (LIVE sharing).
+
+    Changes made through CSSL will reflect back to the original object.
+
+    Args can be passed in either order:
+        share(my_object, "name")  # Preferred
+        share("name", my_object)  # Also works
+
+    Args:
+        instance: Python object to share
+        name: Name to reference in CSSL as $name
+
+    Returns:
+        Path to the shared object marker file
+    """
+    ...
+
+
+def unshare(name: str) -> bool:
+    """
+    Remove a globally shared object.
+
+    Args:
+        name: Name of the shared object to remove
+
+    Returns:
+        True if removed, False if not found
+    """
+    ...
+
+
+def get_shared(name: str) -> Optional[Any]:
+    """
+    Get a globally shared object by name.
+
+    Args:
+        name: Name of the shared object
+
+    Returns:
+        The live shared object or None if not found
+    """
+    ...
+
+
+def shared(name: str) -> Optional[Any]:
+    """
+    Get a shared object by name (alias for get_shared).
+
+    Works with both Python share() and CSSL ==> $name shared objects.
+
+    Usage:
+        from includecpp import CSSL
+
+        # Share an object
+        my_obj = {"value": 42}
+        CSSL.share(my_obj, "data")
+
+        # Retrieve it later
+        obj = CSSL.shared("data")
+        print(obj["value"])  # 42
+
+    Args:
+        name: Name of the shared object (without $ prefix)
+
+    Returns:
+        The live shared object or None if not found
+    """
+    ...
+
+
 __all__: List[str]

includecpp/vscode/cssl/package.json

@@ -1,14 +1,24 @@
 {
     "name": "cssl",
     "displayName": "CSSL - CSO Service Script Language",
-    "description": "Syntax highlighting and language support for CSSL scripts",
-    "version": "1.0.0",
+    "description": "Professional syntax highlighting, snippets, and language support for CSSL scripts (.cssl, .cssl-pl, .cssl-mod)",
+    "version": "1.1.0",
     "publisher": "IncludeCPP",
+    "icon": "images/cssl-icon.png",
     "engines": {
         "vscode": "^1.60.0"
     },
     "categories": [
-        "Programming Languages"
+        "Programming Languages",
+        "Snippets"
+    ],
+    "keywords": [
+        "cssl",
+        "cso",
+        "script",
+        "includecpp",
+        "c++",
+        "python"
     ],
     "contributes": {
         "languages": [
@@ -16,7 +26,11 @@
                 "id": "cssl",
                 "aliases": ["CSSL", "cssl", "CSO Service Script"],
                 "extensions": [".cssl", ".cssl-pl", ".cssl-mod"],
-                "configuration": "./language-configuration.json"
+                "configuration": "./language-configuration.json",
+                "icon": {
+                    "light": "./images/cssl-icon.png",
+                    "dark": "./images/cssl-icon.png"
+                }
             }
         ],
         "grammars": [
@@ -25,6 +39,12 @@
                 "scopeName": "source.cssl",
                 "path": "./syntaxes/cssl.tmLanguage.json"
             }
+        ],
+        "snippets": [
+            {
+                "language": "cssl",
+                "path": "./snippets/cssl.snippets.json"
+            }
         ]
     }
 }