IncludeCPP 3.4.5__tar.gz → 3.4.19__tar.gz

{includecpp-3.4.5 → includecpp-3.4.19}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.4.5
+Version: 3.4.19
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt

{includecpp-3.4.5 → includecpp-3.4.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.4.5
+Version: 3.4.19
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt

{includecpp-3.4.5 → includecpp-3.4.19}/includecpp/__init__.py

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

includecpp-3.4.19/includecpp/__init__.pyi

@@ -0,0 +1,255 @@
+"""Type stubs for includecpp package - VSCode IntelliSense support."""
+
+from typing import Any, Dict, Optional, List, Literal, overload, Callable
+from pathlib import Path
+from types import ModuleType
+import threading
+
+# Import generated module wrappers for VSCode autocomplete
+# These are created by 'includecpp rebuild' and provide module-specific type hints
+try:
+    from .core.cpp_api_extensions import *
+except ImportError:
+    pass  # Generated during rebuild
+
+
+# ========== CSSL Module - CSO Service Script Language ==========
+class _CSSLModule:
+    """CSSL callable module created via CSSL.module()"""
+    def __call__(self, *args: Any) -> Any:
+        """Execute the module code with arguments."""
+        ...
+
+class _CSSLFunctionModule:
+    """CSSL function module created via CSSL.makemodule()"""
+    def __getattr__(self, name: str) -> Callable[..., Any]:
+        """Get a function from the module."""
+        ...
+
+class _CsslLang:
+    """CSSL Language interface."""
+
+    def exec(self, path_or_code: str, *args: Any) -> Any:
+        """Execute CSSL code or file.
+
+        Args:
+            path_or_code: Path to .cssl file or CSSL code string
+            *args: Arguments accessible via parameter.get(index)
+
+        Returns:
+            Execution result
+        """
+        ...
+
+    def T_exec(
+        self,
+        path_or_code: str,
+        *args: Any,
+        callback: Optional[Callable[[Any], None]] = None
+    ) -> threading.Thread:
+        """Execute CSSL code asynchronously in a thread."""
+        ...
+
+    def wait_all(self, timeout: Optional[float] = None) -> None:
+        """Wait for all async executions to complete."""
+        ...
+
+    def get_output(self) -> List[str]:
+        """Get output buffer from last execution."""
+        ...
+
+    def clear_output(self) -> None:
+        """Clear output buffer."""
+        ...
+
+    def set_global(self, name: str, value: Any) -> None:
+        """Set a global variable in CSSL runtime."""
+        ...
+
+    def get_global(self, name: str) -> Any:
+        """Get a global variable from CSSL runtime."""
+        ...
+
+    def module(self, code: str) -> _CSSLModule:
+        """Create a callable CSSL module from code."""
+        ...
+
+    def makemodule(self, code: str) -> _CSSLFunctionModule:
+        """Create a CSSL module with accessible functions."""
+        ...
+
+
+class _CSSLBridge:
+    """CSSL Bridge module - access to CSSL language from Python."""
+
+    CsslLang: type[_CsslLang]
+
+    def exec(self, path_or_code: str, *args: Any) -> Any:
+        """Execute CSSL code or file."""
+        ...
+
+    def _exec(self, code: str, *args: Any) -> Any:
+        """Execute CSSL code (alias for exec)."""
+        ...
+
+    def T_exec(
+        self,
+        path_or_code: str,
+        *args: Any,
+        callback: Optional[Callable[[Any], None]] = None
+    ) -> threading.Thread:
+        """Execute CSSL code asynchronously."""
+        ...
+
+    def _T_exec(
+        self,
+        code: str,
+        *args: Any,
+        callback: Optional[Callable[[Any], None]] = None
+    ) -> threading.Thread:
+        """Execute CSSL code asynchronously (alias)."""
+        ...
+
+    def set_global(self, name: str, value: Any) -> None:
+        """Set a global variable."""
+        ...
+
+    def get_global(self, name: str) -> Any:
+        """Get a global variable."""
+        ...
+
+    def get_output(self) -> List[str]:
+        """Get output buffer."""
+        ...
+
+    def clear_output(self) -> None:
+        """Clear output buffer."""
+        ...
+
+    def module(self, code: str) -> _CSSLModule:
+        """Create a callable CSSL module."""
+        ...
+
+    def makemodule(self, code: str) -> _CSSLFunctionModule:
+        """Create a CSSL function module."""
+        ...
+
+    def get_cssl(self) -> _CsslLang:
+        """Get default CSSL instance."""
+        ...
+
+
+# CSSL module instance - CSO Service Script Language
+CSSL: _CSSLBridge
+
+__version__: str
+
+# Dynamic module access via: from includecpp import <module_name>
+# Auto-generated module declarations
+# These allow: from includecpp import <module_name>
+# (Run 'includecpp rebuild' to generate declarations for your modules)
+
+def __dir__() -> List[str]:
+    """List available modules including dynamically loaded C++ modules."""
+    ...
+
+class ModuleWrapper:
+    """Wrapper for C++ modules with getInfo() and dynamic attributes."""
+
+    def getInfo(self) -> Dict[str, Any]:
+        """Get module metadata including classes, functions, and structs."""
+        ...
+
+    def __getattr__(self, name: str) -> Any: ...
+    def __dir__(self) -> List[str]: ...
+
+class CppApi:
+    """Main API class for including C++ modules with type hints."""
+
+    # Inbuilt module constants
+    FileSystem: str
+    Crypto: str
+    JSON: str
+    StringUtils: str
+    Networking: str
+    DataStructures: str
+    Threading: str
+    StandardMenus: str
+
+    def __init__(
+        self,
+        verbose: bool = False,
+        auto_update: bool = False,
+        config_path: Optional[Path] = None
+    ) -> None: ...
+
+    @property
+    def Inbuilds(self) -> List[str]:
+        """List of available inbuilt modules."""
+        ...
+
+    def exists(self, module_name: str) -> bool:
+        """Check if a module exists."""
+        ...
+
+    # The include() method returns ModuleWrapper with dynamic attributes
+    # VSCode will show getInfo() and other attributes set at runtime
+    def include(
+        self,
+        module_name: str,
+        auto_update: Optional[bool] = None
+    ) -> ModuleWrapper:
+        """Include a C++ module.
+
+        Returns a ModuleWrapper instance with:
+        - getInfo() method for module metadata
+        - Dynamic attributes for classes, functions, and structs
+
+        Example:
+            crypto = api.include("crypto")
+            crypto.getInfo()  # Get module info
+            crypto.Crypto()   # Access Crypto class
+            crypto.md5(...)   # Call md5 function
+
+        Args:
+            module_name: Name of the module to include
+            auto_update: Whether to auto-rebuild if outdated (default: False)
+
+        Returns:
+            ModuleWrapper with module-specific attributes
+        """
+        ...
+
+    def need_update(self, module_name: str) -> bool:
+        """Check if module needs rebuild based on source file changes.
+
+        Args:
+            module_name: Name of module to check
+
+        Returns:
+            True if source files are newer than build
+        """
+        ...
+
+    def update(self, module_name: str, verbose: Optional[bool] = None) -> None:
+        """Rebuild a single module.
+
+        Args:
+            module_name: Name of module to rebuild
+            verbose: Enable verbose output (default: use instance setting)
+        """
+        ...
+
+    def rebuild(
+        self,
+        verbose: bool = False,
+        clean: bool = False
+    ) -> None:
+        """Rebuild C++ modules."""
+        ...
+
+    def list_modules(self) -> List[str]:
+        """List all available modules."""
+        ...
+
+__all__: List[str]  # Includes: CppApi, CSSL, __version__

{includecpp-3.4.5 → includecpp-3.4.19}/includecpp/cli/commands.py

@@ -7455,9 +7455,8 @@ def cssl_exec(path, code):
     try:
         result = cssl_lang.exec(source)
 
-        # Print output buffer
-        for line in cssl_lang.get_output():
-            click.echo(line)
+        # Output is already printed to stdout during execution via runtime.output()
+        # No need to print buffer again - this was causing double output
 
         if result is not None:
             click.echo(f"Result: {result}")
@@ -7508,6 +7507,129 @@ def cssl_makemodule(path, output):
     click.echo(f"  Type: {module_data['type']}")
 
 
+@cssl.command(name='doc')
+def cssl_doc():
+    """Show CSSL documentation."""
+    from pathlib import Path as PathLib
+    import os
+
+    # Find the documentation file relative to this package
+    package_dir = PathLib(__file__).parent.parent.parent
+    doc_path = package_dir / 'CSSL_DOCUMENTATION.md'
+
+    if not doc_path.exists():
+        # Try alternative locations
+        alt_paths = [
+            PathLib(__file__).parent.parent / 'CSSL_DOCUMENTATION.md',
+            PathLib(os.getcwd()) / 'CSSL_DOCUMENTATION.md',
+        ]
+        for alt in alt_paths:
+            if alt.exists():
+                doc_path = alt
+                break
+
+    if doc_path.exists():
+        content = doc_path.read_text(encoding='utf-8')
+        # Use pager for long content
+        click.echo_via_pager(content)
+    else:
+        click.secho("Documentation file not found.", fg='yellow')
+        click.echo("Looking for: CSSL_DOCUMENTATION.md")
+        click.echo()
+        click.echo("Quick Reference:")
+        click.echo("  - Variables: string x = \"hello\"; int n = 42;")
+        click.echo("  - Functions: void foo() { } or define bar() { }")
+        click.echo("  - Loops: for (i in range(0, 10)) { } or for (int i = 0; i < 10; i++) { }")
+        click.echo("  - Conditions: if (x) { } elif (y) { } else { }")
+        click.echo("  - Containers: stack<T>, vector<T>, array<T>")
+        click.echo("  - Globals: global x = value; @x")
+        click.echo("  - Payloads: payload(\"file.cssl-pl\");")
+        click.echo()
+        click.echo("For full docs, see: https://github.com/liliassg/IncludeCPP")
+
+
+@cssl.command(name='create')
+@click.argument('name')
+@click.option('--dir', '-d', type=click.Path(), default='.', help='Output directory')
+def cssl_create(name, dir):
+    """Create a new CSSL project with .cssl and .cssl-pl files."""
+    from pathlib import Path as PathLib
+
+    out_dir = PathLib(dir)
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    cssl_file = out_dir / f"{name}.cssl"
+    payload_file = out_dir / f"{name}.cssl-pl"
+
+    # Create .cssl file
+    cssl_content = f'''// {name}.cssl - CSSL Application
+// Created with: includecpp cssl create {name}
+
+// Load payload (globals, injections, config)
+payload("{name}.cssl-pl");
+
+// Main application code
+void main() {{
+    printl("Hello from {name}!");
+    printl("Version: " + @version);
+}}
+
+main();
+'''
+
+    # Create .cssl-pl payload file
+    payload_content = f'''// {name}.cssl-pl - CSSL Payload
+// Loaded via: payload("{name}.cssl-pl");
+
+// ============================================================================
+// Configuration & Variables
+// ============================================================================
+global version = "1.0.0";
+global appName = "{name}";
+global debug = false;
+
+// ============================================================================
+// Builtin Injections
+// ============================================================================
+// Inject cleanup code into exit()
+exit() <<== {{
+    if (@debug) {{
+        printl("[DEBUG] {name} shutting down...");
+    }}
+}}
+
+// ============================================================================
+// Helper Functions (globally callable via @functionName)
+// ============================================================================
+void log(string message) {{
+    if (@debug) {{
+        printl("[LOG] " + message);
+    }}
+}}
+
+void error(string message) {{
+    printl("[ERROR] " + message);
+}}
+'''
+
+    # Write files
+    cssl_file.write_text(cssl_content, encoding='utf-8')
+    payload_file.write_text(payload_content, encoding='utf-8')
+
+    click.secho(f"Created CSSL project: {name}", fg='green', bold=True)
+    click.echo()
+    click.echo("Files created:")
+    click.echo(f"  {cssl_file}  - Main application")
+    click.echo(f"  {payload_file}  - Payload (globals, injections)")
+    click.echo()
+    click.echo("Run with:")
+    click.secho(f"  includecpp cssl exec {cssl_file}", fg='cyan')
+    click.echo()
+    click.echo("Or from Python:")
+    click.echo("  from includecpp import CSSL")
+    click.echo(f"  CSSL.exec('{cssl_file}')")
+
+
 # Register hidden cssl command group
 cli.add_command(cssl)
 

{includecpp-3.4.5 → includecpp-3.4.19}/includecpp/core/cssl/__init__.py

@@ -14,27 +14,29 @@ Features:
 from .cssl_parser import (
     parse_cssl, parse_cssl_program, tokenize_cssl,
     CSSLSyntaxError, CSSLLexer, CSSLParser, ASTNode,
-    KEYWORDS, TYPE_GENERICS, INJECTION_HELPERS
+    KEYWORDS, TYPE_GENERICS, TYPE_PARAM_FUNCTIONS, INJECTION_HELPERS
 )
 from .cssl_runtime import CSSLRuntime, CSSLRuntimeError, CSSLServiceRunner, run_cssl, run_cssl_file
 from .cssl_types import (
     DataStruct, Shuffled, Iterator, Combo, DataSpace, OpenQuote,
-    OpenFind,
+    OpenFind, Parameter, Stack, Vector, Array,
     create_datastruct, create_shuffled, create_iterator,
-    create_combo, create_dataspace, create_openquote
+    create_combo, create_dataspace, create_openquote, create_parameter,
+    create_stack, create_vector, create_array
 )
 
 __all__ = [
     # Parser
     'parse_cssl', 'parse_cssl_program', 'tokenize_cssl',
     'CSSLSyntaxError', 'CSSLLexer', 'CSSLParser', 'ASTNode',
-    'KEYWORDS', 'TYPE_GENERICS', 'INJECTION_HELPERS',
+    'KEYWORDS', 'TYPE_GENERICS', 'TYPE_PARAM_FUNCTIONS', 'INJECTION_HELPERS',
     # Runtime
     'CSSLRuntime', 'CSSLRuntimeError', 'CSSLServiceRunner',
     'run_cssl', 'run_cssl_file',
     # Data Types
     'DataStruct', 'Shuffled', 'Iterator', 'Combo', 'DataSpace', 'OpenQuote',
-    'OpenFind',
+    'OpenFind', 'Parameter', 'Stack', 'Vector', 'Array',
     'create_datastruct', 'create_shuffled', 'create_iterator',
-    'create_combo', 'create_dataspace', 'create_openquote'
+    'create_combo', 'create_dataspace', 'create_openquote', 'create_parameter',
+    'create_stack', 'create_vector', 'create_array'
 ]