IncludeCPP 3.7.5__tar.gz → 3.7.11__tar.gz

{includecpp-3.7.5 → includecpp-3.7.11}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.7.5
+Version: 3.7.11
 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.7.5 → includecpp-3.7.11}/IncludeCPP.egg-info/SOURCES.txt

@@ -45,6 +45,8 @@ setup.py
 ./includecpp/vscode/cssl/__init__.py
 ./includecpp/vscode/cssl/language-configuration.json
 ./includecpp/vscode/cssl/package.json
+./includecpp/vscode/cssl/images/cssl.png
+./includecpp/vscode/cssl/images/cssl_pl.png
 ./includecpp/vscode/cssl/snippets/cssl.snippets.json
 ./includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json
 IncludeCPP.egg-info/PKG-INFO
@@ -94,5 +96,7 @@ includecpp/vscode/__init__.py
 includecpp/vscode/cssl/__init__.py
 includecpp/vscode/cssl/language-configuration.json
 includecpp/vscode/cssl/package.json
+includecpp/vscode/cssl/images/cssl.png
+includecpp/vscode/cssl/images/cssl_pl.png
 includecpp/vscode/cssl/snippets/cssl.snippets.json
 includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json

{includecpp-3.7.5 → includecpp-3.7.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.7.5
+Version: 3.7.11
 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.7.5 → includecpp-3.7.11}/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.5"
+__version__ = "3.7.11"
 __all__ = ["CppApi", "CSSL"]
 
 # Module-level cache for C++ modules

{includecpp-3.7.5 → includecpp-3.7.11}/includecpp/cli/commands.py

@@ -1193,7 +1193,7 @@ def build(ctx, clean, keep, verbose, no_incremental, incremental, parallel, jobs
 @cli.command()
 @click.argument('module_name')
 def add(module_name):
-    """Create a new module template."""
+    """Create a new module template with sample C++ code."""
     plugins_dir = Path("plugins")
     if not plugins_dir.exists():
         click.echo("Error: plugins/ directory not found")
@@ -1204,6 +1204,7 @@ def add(module_name):
         click.echo(f"Module {module_name} already exists")
         return
 
+    # Create .cp config file
     template = f"""SOURCE(include/{module_name}.cpp) {module_name}
 
 PUBLIC(
@@ -1215,7 +1216,41 @@ PUBLIC(
         f.write(template)
 
     click.echo(f"Created {cp_file}")
-    click.echo(f"Now create include/{module_name}.cpp with your C++ code")
+
+    # Create include/ directory if it doesn't exist
+    include_dir = Path("include")
+    include_dir.mkdir(exist_ok=True)
+
+    # Create .cpp file with sample code
+    cpp_file = include_dir / f"{module_name}.cpp"
+    if not cpp_file.exists():
+        cpp_template = f"""#include <string>
+#include <vector>
+
+namespace includecpp {{
+
+// Example function - returns a greeting
+std::string example_function(const std::string& name) {{
+    return "Hello, " + name + "!";
+}}
+
+// Add more functions here...
+// int add(int a, int b) {{ return a + b; }}
+// std::vector<int> range(int n) {{ ... }}
+
+}} // namespace includecpp
+"""
+        with open(cpp_file, 'w', encoding='utf-8') as f:
+            f.write(cpp_template)
+
+        click.echo(f"Created {cpp_file}")
+    else:
+        click.echo(f"Note: {cpp_file} already exists, skipped")
+
+    click.echo(f"\nNext steps:")
+    click.echo(f"  1. Edit include/{module_name}.cpp to add your functions")
+    click.echo(f"  2. Update plugins/{module_name}.cp to expose functions")
+    click.echo(f"  3. Run: includecpp rebuild")
 
 @cli.command('list')
 def list_modules():
@@ -7480,13 +7515,12 @@ def cssl_exec(path, code):
     # Execute
     click.secho("--- Output ---", fg='green')
     try:
-        result = cssl_lang.exec(source)
+        result = cssl_lang.run(source)
 
         # 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}")
+        # Don't print "Result:" automatically - users should use printl() for output
+        # This prevents unwanted output for function calls like: Function();
+        pass
 
     except Exception as e:
         click.secho(f"CSSL Error: {e}", fg='red')
@@ -7595,75 +7629,95 @@ def cssl_doc(search, list_sections):
             click.secho("=" * 50, fg='cyan')
             click.echo()
 
-            # Split into sections (## headers)
-            sections = re.split(r'(?=^## )', content, flags=re.MULTILINE)
-
-            found_sections = []
-            for section in sections:
-                if search.lower() in section.lower():
-                    found_sections.append(section)
-
-            if found_sections:
-                # Also find specific lines with the search term
-                all_lines = content.split('\n')
-                matching_lines = []
-                for i, line in enumerate(all_lines):
-                    if search.lower() in line.lower():
-                        # Get context (2 lines before and after)
-                        start = max(0, i - 2)
-                        end = min(len(all_lines), i + 3)
-                        context = '\n'.join(all_lines[start:end])
-                        if context not in matching_lines:
-                            matching_lines.append((i + 1, context))
-
-                # Show summary
-                click.secho(f"Found in {len(found_sections)} section(s):", fg='green')
-                for section in found_sections:
-                    # Extract section title
-                    title_match = re.match(r'^##\s+(.+)$', section, re.MULTILINE)
-                    if title_match:
-                        click.echo(f"  - {title_match.group(1)}")
+            # Split into subsections (### headers) for focused results
+            subsections = re.split(r'(?=^### )', content, flags=re.MULTILINE)
 
-                click.echo()
+            # Also split into main sections (## headers)
+            main_sections = re.split(r'(?=^## )', content, flags=re.MULTILINE)
 
-                # Show matching contexts with highlighting
-                click.secho("Matching content:", fg='yellow', bold=True)
-                click.secho("-" * 50, fg='yellow')
+            # Find matching subsections (### level) - most focused
+            matching_subsections = []
+            for subsection in subsections:
+                if search.lower() in subsection.lower():
+                    # Extract title
+                    title_match = re.match(r'^###\s+(.+)$', subsection, re.MULTILINE)
+                    if title_match:
+                        # Trim subsection to just the content until next ### or ##
+                        lines = subsection.split('\n')
+                        trimmed_lines = []
+                        for line in lines:
+                            if line.startswith('## ') and not line.startswith('### '):
+                                break
+                            trimmed_lines.append(line)
+                        matching_subsections.append((title_match.group(1), '\n'.join(trimmed_lines)))
+
+            if matching_subsections:
+                click.secho(f"Found {len(matching_subsections)} matching subsection(s):", fg='green')
+                click.echo()
 
-                for line_num, context in matching_lines[:15]:  # Limit to 15 matches
-                    click.echo(f"\nLine {line_num}:")
-                    # Highlight the search term
+                # Show focused subsections (limit output)
+                for title, sub_content in matching_subsections[:5]:
+                    click.secho(f"### {title}", fg='yellow', bold=True)
+                    # Highlight search term in content
                     highlighted = re.sub(
                         f'({re.escape(search)})',
                         click.style(r'\1', fg='green', bold=True),
-                        context,
+                        sub_content,
                         flags=re.IGNORECASE
                     )
-                    click.echo(highlighted)
-                    click.echo("-" * 30)
-
-                if len(matching_lines) > 15:
-                    click.echo(f"\n... and {len(matching_lines) - 15} more matches")
-
-                # Offer to show full sections
-                click.echo()
-                click.secho("Full sections containing your search:", fg='cyan')
-                click.echo("(Scroll or pipe to a file for full content)")
-                click.echo()
-
-                for section in found_sections:
-                    click.echo(section)
+                    # Limit lines per subsection
+                    lines = highlighted.split('\n')
+                    if len(lines) > 30:
+                        click.echo('\n'.join(lines[:30]))
+                        click.secho(f"  ... ({len(lines) - 30} more lines)", fg='cyan')
+                    else:
+                        click.echo(highlighted)
+                    click.echo()
+                    click.secho("-" * 40, fg='cyan')
                     click.echo()
 
+                if len(matching_subsections) > 5:
+                    click.secho(f"... and {len(matching_subsections) - 5} more subsections", fg='cyan')
+                    click.echo("Use --list to see all sections")
             else:
-                click.secho(f"No matches found for '{search}'", fg='yellow')
-                click.echo()
-                click.echo("Try searching for:")
-                click.echo("  - Keywords: class, function, define, open, global")
-                click.echo("  - Syntax: $, @, ::, this->, <<==, <==")
-                click.echo("  - Types: string, int, stack, vector, map, json")
-                click.echo()
-                click.echo("Or use: includecpp cssl doc --list")
+                # Fall back to main section search (## level)
+                found_sections = []
+                for section in main_sections:
+                    if search.lower() in section.lower():
+                        title_match = re.match(r'^##\s+(.+)$', section, re.MULTILINE)
+                        if title_match:
+                            found_sections.append((title_match.group(1), section))
+
+                if found_sections:
+                    click.secho(f"Found in {len(found_sections)} section(s):", fg='green')
+                    for title, _ in found_sections:
+                        click.echo(f"  - {title}")
+                    click.echo()
+
+                    # Show first matching section, trimmed
+                    title, section = found_sections[0]
+                    click.secho(f"## {title}", fg='yellow', bold=True)
+                    highlighted = re.sub(
+                        f'({re.escape(search)})',
+                        click.style(r'\1', fg='green', bold=True),
+                        section,
+                        flags=re.IGNORECASE
+                    )
+                    lines = highlighted.split('\n')
+                    if len(lines) > 40:
+                        click.echo('\n'.join(lines[:40]))
+                        click.secho(f"\n... ({len(lines) - 40} more lines in this section)", fg='cyan')
+                    else:
+                        click.echo(highlighted)
+                else:
+                    click.secho(f"No matches found for '{search}'", fg='yellow')
+                    click.echo()
+                    click.echo("Try searching for:")
+                    click.echo("  - Keywords: class, function, define, open, global, shuffled")
+                    click.echo("  - Syntax: $, @, ::, this->, <<==, <==, #$")
+                    click.echo("  - Types: string, int, stack, vector, map, json")
+                    click.echo()
+                    click.echo("Or use: includecpp cssl doc --list")
         else:
             # Full documentation mode
             click.echo_via_pager(content)
@@ -7804,26 +7858,46 @@ def cssl_vscode():
         click.secho("CSSL extension files not found in package.", fg='red')
         return
 
-    # Install extension
-    target_dir = vscode_ext_dir / 'includecpp.cssl-1.0.0'
+    # Get version from package.json
+    pkg_json = source_ext_dir / 'package.json'
+    current_version = "1.1.0"
+    if pkg_json.exists():
+        try:
+            pkg_data = json.loads(pkg_json.read_text(encoding='utf-8'))
+            current_version = pkg_data.get('version', '1.1.0')
+        except:
+            pass
+
+    target_dir = vscode_ext_dir / f'includecpp.cssl-{current_version}'
 
     try:
+        # Check for existing installations
+        existing_version = None
+        for existing in vscode_ext_dir.glob('includecpp.cssl-*'):
+            existing_version = existing.name.split('-')[-1]
+            if existing_version != current_version:
+                click.echo(f"Removing old version: {existing_version}")
+                shutil.rmtree(existing)
+
         if target_dir.exists():
             shutil.rmtree(target_dir)
 
         shutil.copytree(source_ext_dir, target_dir)
 
-        click.secho("CSSL VSCode extension installed!", fg='green', bold=True)
+        if existing_version and existing_version != current_version:
+            click.secho(f"CSSL extension updated: v{existing_version} -> v{current_version}", fg='green', bold=True)
+        else:
+            click.secho(f"CSSL VSCode extension installed! (v{current_version})", fg='green', bold=True)
         click.echo()
         click.echo(f"Installed to: {target_dir}")
         click.echo()
         click.echo("Features:")
         click.echo("  - Syntax highlighting for .cssl, .cssl-pl, .cssl-mod files")
-        click.echo("  - BruteInjection operators: <==, ==>, <<==, +<==, etc.")
-        click.echo("  - Type highlighting: int, string, stack<T>, datastruct<T>")
+        click.echo("  - OOP support: class, constructor, this->member")
+        click.echo("  - Injection operators: <== (brute), <<== (infuse)")
+        click.echo("  - Type highlighting: int, string, stack<T>, instance<>")
         click.echo("  - Global references: @Name, r@Name, s@Name")
         click.echo("  - Shared objects: $Name")
-        click.echo("  - Filter helpers: string::contains, json::key, etc.")
         click.echo()
         click.secho("Restart VSCode to activate the extension.", fg='yellow')
 
@@ -7847,35 +7921,28 @@ cli.add_command(cssl)
 def vscode(force, stubs_only):
     """Initialize or update VSCode configuration for IncludeCPP/CSSL.
 
-    Sets up .vscode folder with:
-    - CSSL language support (syntax highlighting, snippets)
-    - Type stubs for builtins (.pyi files)
-    - Auto-generated stubs for your plugins and modules
+    Installs CSSL extension globally and sets up project stubs.
 
     \b
     Usage:
-      includecpp vscode           # Initialize .vscode
-      includecpp vscode --force   # Force overwrite existing
+      includecpp vscode           # Install/update extension + stubs
+      includecpp vscode --force   # Force reinstall extension
       includecpp vscode --stubs-only  # Only update stubs
 
     \b
-    What it creates:
-      .vscode/
-        settings.json         - VSCode settings for CSSL
-        cssl/                 - CSSL language extension
-        stubs/                - Type stubs for IDE support
-          cssl_builtins.pyi   - CSSL builtin functions
-          plugins/            - Stubs for your .cp plugins
-          modules/            - Stubs for your modules
+    What it does:
+      1. Installs CSSL extension globally (~/.vscode/extensions/)
+      2. Creates .vscode/settings.json with file associations
+      3. Creates .vscode/stubs/ with type hints for IDE support
     """
     from pathlib import Path as PathLib
+    import os
 
     cwd = PathLib.cwd()
     vscode_dir = cwd / '.vscode'
     stubs_dir = vscode_dir / 'stubs'
     plugins_stubs_dir = stubs_dir / 'plugins'
     modules_stubs_dir = stubs_dir / 'modules'
-    cssl_ext_dir = vscode_dir / 'cssl'
 
     # Create directories
     vscode_dir.mkdir(exist_ok=True)
@@ -7891,56 +7958,79 @@ def vscode(force, stubs_only):
     updated_count = 0
     created_count = 0
 
-    # 1. Copy CSSL extension files (unless stubs-only)
+    # 1. Install CSSL extension GLOBALLY (unless stubs-only)
     if not stubs_only:
-        click.secho("Setting up CSSL language support...", fg='yellow')
+        click.secho("Installing CSSL extension globally...", fg='yellow')
 
         # Find source extension directory
         source_ext_dir = PathLib(__file__).parent.parent / 'vscode' / 'cssl'
 
         if source_ext_dir.exists():
-            cssl_ext_dir.mkdir(exist_ok=True)
-
-            # Copy extension files
-            ext_files = [
-                'language-configuration.json',
-                'package.json',
-            ]
-
-            for fname in ext_files:
-                src = source_ext_dir / fname
-                dst = cssl_ext_dir / fname
-                if src.exists():
-                    if not dst.exists() or force:
-                        shutil.copy2(src, dst)
-                        created_count += 1
-                        click.echo(f"  Created: .vscode/cssl/{fname}")
-
-            # Copy syntaxes folder
-            syntaxes_src = source_ext_dir / 'syntaxes'
-            syntaxes_dst = cssl_ext_dir / 'syntaxes'
-            if syntaxes_src.exists():
-                syntaxes_dst.mkdir(exist_ok=True)
-                for f in syntaxes_src.glob('*.json'):
-                    dst = syntaxes_dst / f.name
-                    if not dst.exists() or force:
-                        shutil.copy2(f, dst)
-                        created_count += 1
-                        click.echo(f"  Created: .vscode/cssl/syntaxes/{f.name}")
-
-            # Copy snippets folder
-            snippets_src = source_ext_dir / 'snippets'
-            snippets_dst = cssl_ext_dir / 'snippets'
-            if snippets_src.exists():
-                snippets_dst.mkdir(exist_ok=True)
-                for f in snippets_src.glob('*.json'):
-                    dst = snippets_dst / f.name
-                    if not dst.exists() or force:
-                        shutil.copy2(f, dst)
-                        created_count += 1
-                        click.echo(f"  Created: .vscode/cssl/snippets/{f.name}")
+            # Get version from package.json
+            pkg_json = source_ext_dir / 'package.json'
+            current_version = "1.1.0"
+            if pkg_json.exists():
+                try:
+                    pkg_data = json.loads(pkg_json.read_text(encoding='utf-8'))
+                    current_version = pkg_data.get('version', '1.1.0')
+                except:
+                    pass
+
+            # Find global VSCode extensions directory
+            if os.name == 'nt':  # Windows
+                global_ext_dir = PathLib(os.environ.get('USERPROFILE', '')) / '.vscode' / 'extensions'
+            else:  # Linux/Mac
+                global_ext_dir = PathLib.home() / '.vscode' / 'extensions'
+
+            if not global_ext_dir.exists():
+                # Try VSCode Insiders
+                if os.name == 'nt':
+                    global_ext_dir = PathLib(os.environ.get('USERPROFILE', '')) / '.vscode-insiders' / 'extensions'
+                else:
+                    global_ext_dir = PathLib.home() / '.vscode-insiders' / 'extensions'
+
+            if global_ext_dir.exists():
+                target_dir = global_ext_dir / f'includecpp.cssl-{current_version}'
+
+                # Check if already installed with same or older version
+                needs_install = force
+                existing_version = None
+
+                # Find existing installations
+                for existing in global_ext_dir.glob('includecpp.cssl-*'):
+                    existing_version = existing.name.split('-')[-1]
+                    if existing_version != current_version:
+                        # Remove old version
+                        click.echo(f"  Removing old version: {existing_version}")
+                        shutil.rmtree(existing)
+                        needs_install = True
+                    elif not force:
+                        click.echo(f"  Already installed: v{current_version}")
+                        needs_install = False
+
+                if not target_dir.exists():
+                    needs_install = True
+
+                if needs_install:
+                    # Remove target if exists (force reinstall)
+                    if target_dir.exists():
+                        shutil.rmtree(target_dir)
+
+                    # Copy extension to global directory
+                    shutil.copytree(source_ext_dir, target_dir)
+                    created_count += 1
+
+                    if existing_version and existing_version != current_version:
+                        click.secho(f"  Updated: v{existing_version} -> v{current_version}", fg='green')
+                    else:
+                        click.secho(f"  Installed: v{current_version}", fg='green')
 
-            click.secho("  CSSL extension configured", fg='green')
+                    click.echo(f"  Location: {target_dir}")
+                    click.echo()
+                    click.secho("  Restart VSCode to activate the extension!", fg='yellow', bold=True)
+            else:
+                click.secho("  VSCode extensions directory not found.", fg='red')
+                click.echo("  Make sure VSCode is installed.")
         else:
             click.secho("  Warning: CSSL extension source not found", fg='yellow')
 

{includecpp-3.7.5 → includecpp-3.7.11}/includecpp/core/cssl/CSSL_DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # CSSL - C-Style Scripting Language
 
-> Version 3.7.2 | A modern scripting language with C++-style syntax and unique features like CodeInfusion and BruteInjection.
+> Version 3.7.6 | A modern scripting language with C++-style syntax and unique features like CodeInfusion and BruteInjection.
 
 ---
 
@@ -41,22 +41,25 @@
 ```python
 from includecpp import CSSL
 
-# Initialize CSSL
-CSSL.CsslLang()
-
-# Execute code
-CSSL.exec("""
+# Execute code (v3.7.6+: use run() instead of exec())
+CSSL.run("""
     printl("Hello CSSL!");
 """)
 
 # With parameters and return value
-result = CSSL.exec("""
+result = CSSL.run("""
     string name = parameter.get(0);
     printl("Hello " + name);
     parameter.return(true);
 """, "World")
 
 print(result)  # True
+
+# Create typed scripts and modules (v3.7.6+)
+main = CSSL.script("cssl", '''printl("Main");''')
+payload = CSSL.script("cssl-pl", '''void helper() { printl("Helper!"); }''')
+mod = CSSL.makemodule(main, payload, "mymod")
+mod.helper()  # Call function directly
 ```
 
 ### CLI Execution
@@ -701,12 +704,24 @@ super void forceRun() {
 
 ### shuffled
 
-Allows multiple return values.
+Allows multiple return values with tuple unpacking.
 
 ```cssl
 shuffled string getNames() {
     return "Alice", "Bob", "Charlie";
 }
+
+// Tuple unpacking (v3.7.6+)
+a, b, c = getNames();
+printl(a);  // "Alice"
+printl(b);  // "Bob"
+printl(c);  // "Charlie"
+
+// Works with any types
+shuffled getValues() {
+    return "text", 42, true;
+}
+name, num, flag = getValues();
 ```
 
 ---
@@ -1143,6 +1158,10 @@ print(stats.total)  # 50 - Persisted!
 
 CodeInfusion enables modifying functions at runtime.
 
+> **Important**: Injection operators must be written **without spaces**:
+> - ✓ `func() <<==` / `func() +<<==` / `func() -<<==` (correct)
+> - ✗ `func() < <==` / `func() + <<==` / `func() - <<==` (wrong)
+
 ### <<== (Replace)
 
 Replaces function content.

{includecpp-3.7.5 → includecpp-3.7.11}/includecpp/core/cssl/cssl_parser.py

@@ -1776,11 +1776,31 @@ class CSSLParser:
         return node
 
     def _parse_return(self) -> ASTNode:
-        value = None
+        """Parse return statement, supporting multiple values for shuffled functions.
+
+        Syntax:
+            return;                    // Return None
+            return value;              // Return single value
+            return a, b, c;            // Return multiple values (for shuffled)
+        """
+        values = []
         if not self._check(TokenType.SEMICOLON) and not self._check(TokenType.BLOCK_END):
-            value = self._parse_expression()
+            values.append(self._parse_expression())
+
+            # Check for comma-separated return values (shuffled return)
+            while self._check(TokenType.COMMA):
+                self._advance()  # consume comma
+                values.append(self._parse_expression())
+
         self._match(TokenType.SEMICOLON)
-        return ASTNode('return', value=value)
+
+        if len(values) == 0:
+            return ASTNode('return', value=None)
+        elif len(values) == 1:
+            return ASTNode('return', value=values[0])
+        else:
+            # Multiple return values - create tuple return
+            return ASTNode('return', value={'multiple': True, 'values': values})
 
     def _parse_super_function(self) -> ASTNode:
         """Parse super-function for .cssl-pl payload files.
@@ -1892,6 +1912,25 @@ class CSSLParser:
     def _parse_expression_statement(self) -> Optional[ASTNode]:
         expr = self._parse_expression()
 
+        # === TUPLE UNPACKING: a, b, c = shuffled_func() ===
+        # Check if we have comma-separated identifiers before =
+        if expr.type == 'identifier' and self._check(TokenType.COMMA):
+            targets = [expr]
+            while self._match(TokenType.COMMA):
+                next_expr = self._parse_expression()
+                if next_expr.type == 'identifier':
+                    targets.append(next_expr)
+                else:
+                    # Not a simple identifier list, this is something else
+                    # Restore and fall through to normal parsing
+                    break
+
+            # Check if followed by =
+            if self._match(TokenType.EQUALS):
+                value = self._parse_expression()
+                self._match(TokenType.SEMICOLON)
+                return ASTNode('tuple_assignment', value={'targets': targets, 'value': value})
+
         # === BASIC INJECTION: <== (replace target with source) ===
         if self._match(TokenType.INJECT_LEFT):
             # Check if this is a createcmd injection with a code block