IncludeCPP 3.7.1__tar.gz → 3.7.2__tar.gz

{includecpp-3.7.1 → includecpp-3.7.2}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.7.1
+Version: 3.7.2
 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.1 → includecpp-3.7.2}/PKG-INFO

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

{includecpp-3.7.1 → includecpp-3.7.2}/includecpp/cli/commands.py

@@ -7535,10 +7535,29 @@ def cssl_makemodule(path, output):
 
 
 @cssl.command(name='doc')
-def cssl_doc():
-    """Show CSSL documentation."""
+@click.argument('search', required=False, default=None)
+@click.option('--list', '-l', 'list_sections', is_flag=True, help='List all documentation sections')
+def cssl_doc(search, list_sections):
+    """Show CSSL documentation.
+
+    \b
+    Usage:
+      includecpp cssl doc              # Show full documentation
+      includecpp cssl doc "open"       # Search for 'open' keyword
+      includecpp cssl doc "$"          # Search for shared variable syntax
+      includecpp cssl doc "define"     # Search for define keyword
+      includecpp cssl doc --list       # List all sections
+
+    \b
+    Examples:
+      includecpp cssl doc "class"      # Show OOP/class documentation
+      includecpp cssl doc "json::"     # Show JSON functions
+      includecpp cssl doc "this->"     # Show this-> keyword usage
+      includecpp cssl doc "map"        # Show Map container docs
+    """
     from pathlib import Path as PathLib
     import os
+    import re
 
     # Find the documentation file in the cssl package directory
     cssl_dir = PathLib(__file__).parent.parent / 'core' / 'cssl'
@@ -7558,8 +7577,96 @@ def cssl_doc():
 
     if doc_path.exists():
         content = doc_path.read_text(encoding='utf-8')
-        # Use pager for long content
-        click.echo_via_pager(content)
+
+        # List sections mode
+        if list_sections:
+            click.secho("CSSL Documentation Sections", fg='cyan', bold=True)
+            click.secho("=" * 40, fg='cyan')
+            sections = re.findall(r'^##\s+(.+)$', content, re.MULTILINE)
+            for i, section in enumerate(sections, 1):
+                click.echo(f"  {i:2d}. {section}")
+            click.echo()
+            click.echo("Use: includecpp cssl doc \"<keyword>\" to search")
+            return
+
+        # Search mode
+        if search:
+            click.secho(f"Searching for: '{search}'", fg='cyan', bold=True)
+            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)}")
+
+                click.echo()
+
+                # Show matching contexts with highlighting
+                click.secho("Matching content:", fg='yellow', bold=True)
+                click.secho("-" * 50, fg='yellow')
+
+                for line_num, context in matching_lines[:15]:  # Limit to 15 matches
+                    click.echo(f"\nLine {line_num}:")
+                    # Highlight the search term
+                    highlighted = re.sub(
+                        f'({re.escape(search)})',
+                        click.style(r'\1', fg='green', bold=True),
+                        context,
+                        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)
+                    click.echo()
+
+            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")
+        else:
+            # Full documentation mode
+            click.echo_via_pager(content)
     else:
         click.secho("Documentation file not found.", fg='yellow')
         click.echo("Looking for: CSSL_DOCUMENTATION.md")

{includecpp-3.7.1 → includecpp-3.7.2}/includecpp/core/cssl/CSSL_DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # CSSL - C-Style Scripting Language
 
-> Version 3.7.0 | A modern scripting language with C++-style syntax and unique features like CodeInfusion and BruteInjection.
+> Version 3.7.2 | A modern scripting language with C++-style syntax and unique features like CodeInfusion and BruteInjection.
 
 ---
 

{includecpp-3.7.1 → includecpp-3.7.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "IncludeCPP"
-version = "3.7.1"
+version = "3.7.2"
 description = "Professional C++ Python bindings with type-generic templates, pystubs and native threading"
 readme = "README.md"
 requires-python = ">=3.9"

{includecpp-3.7.1 → includecpp-3.7.2}/setup.py

@@ -6,7 +6,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
 
 setup(
     name="IncludeCPP",
-    version="3.7.1",
+    version="3.7.2",
     author="Lilias Hatterscheidt",
     author_email="lilias@includecpp.dev",
     description="Professional C++ Python bindings with type-generic templates and native threading",