IncludeCPP 2.5.2__tar.gz → 2.7.2__tar.gz

{includecpp-2.5.2 → includecpp-2.7.2}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 2.5.2
+Version: 2.7.2
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/includecpp/includecpp
 Author: IncludeCPP Team
@@ -116,17 +116,19 @@ includecpp rebuild [OPTIONS]
 ```
 
 **Options:**
-- `--clean` - Force clean rebuild (ignore incremental cache)
-- `--full` - Complete rebuild including generator and all caches
+- `--clean` - Force clean rebuild (delete all cached files)
+- `--keep` - Keep existing generator (skip automatic generator rebuild)
 - `--verbose` - Detailed build output
 - `--no-incremental` - Disable incremental builds
 - `--parallel/--no-parallel` - Enable/disable parallel compilation (default: enabled)
 - `-j, --jobs <N>` - Max parallel jobs (default: 4)
 - `-m, --modules <name>` - Rebuild specific modules only
 
+**Note:** The generator is automatically rebuilt on each run to ensure it's up-to-date. Use `--keep` to skip this if you know the generator is current.
+
 **Examples:**
 ```bash
-includecpp rebuild --full --verbose
+includecpp rebuild --verbose
 includecpp rebuild -m crypto -m networking
 ```
 
@@ -337,6 +339,15 @@ SHA256-based change detection. Only rebuilds modified modules.
 
 ## Python API
 
+### Simple Import (v2.6+)
+
+```python
+from includecpp import fast_list
+result = fast_list.fast_sort([3, 1, 2])
+```
+
+### Classic API
+
 ```python
 from includecpp import CppApi
 
@@ -368,5 +379,5 @@ api.exists("module_name")       # Check if module exists
 ---
 
 **License:** MIT
-**Version:** 2.5.2
+**Version:** 2.6.1
 **Repository:** https://github.com/liliassg/IncludeCPP

{includecpp-2.5.2 → includecpp-2.7.2}/IncludeCPP.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ setup.py
 ./includecpp/__init__.py
 ./includecpp/__init__.pyi
 ./includecpp/__main__.py
+./includecpp/py.typed
 ./includecpp/cli/__init__.py
 ./includecpp/cli/commands.py
 ./includecpp/cli/config_parser.py
@@ -14,6 +15,7 @@ setup.py
 ./includecpp/core/build_manager.py
 ./includecpp/core/cpp_api.py
 ./includecpp/core/cpp_api.pyi
+./includecpp/core/error_catalog.py
 ./includecpp/core/error_formatter.py
 ./includecpp/core/exceptions.py
 ./includecpp/core/path_discovery.py
@@ -32,6 +34,7 @@ IncludeCPP.egg-info/top_level.txt
 includecpp/__init__.py
 includecpp/__init__.pyi
 includecpp/__main__.py
+includecpp/py.typed
 includecpp/cli/__init__.py
 includecpp/cli/commands.py
 includecpp/cli/config_parser.py
@@ -39,6 +42,7 @@ includecpp/core/__init__.py
 includecpp/core/build_manager.py
 includecpp/core/cpp_api.py
 includecpp/core/cpp_api.pyi
+includecpp/core/error_catalog.py
 includecpp/core/error_formatter.py
 includecpp/core/exceptions.py
 includecpp/core/path_discovery.py

{includecpp-2.5.2 → includecpp-2.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 2.5.2
+Version: 2.7.2
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/includecpp/includecpp
 Author: IncludeCPP Team
@@ -116,17 +116,19 @@ includecpp rebuild [OPTIONS]
 ```
 
 **Options:**
-- `--clean` - Force clean rebuild (ignore incremental cache)
-- `--full` - Complete rebuild including generator and all caches
+- `--clean` - Force clean rebuild (delete all cached files)
+- `--keep` - Keep existing generator (skip automatic generator rebuild)
 - `--verbose` - Detailed build output
 - `--no-incremental` - Disable incremental builds
 - `--parallel/--no-parallel` - Enable/disable parallel compilation (default: enabled)
 - `-j, --jobs <N>` - Max parallel jobs (default: 4)
 - `-m, --modules <name>` - Rebuild specific modules only
 
+**Note:** The generator is automatically rebuilt on each run to ensure it's up-to-date. Use `--keep` to skip this if you know the generator is current.
+
 **Examples:**
 ```bash
-includecpp rebuild --full --verbose
+includecpp rebuild --verbose
 includecpp rebuild -m crypto -m networking
 ```
 
@@ -337,6 +339,15 @@ SHA256-based change detection. Only rebuilds modified modules.
 
 ## Python API
 
+### Simple Import (v2.6+)
+
+```python
+from includecpp import fast_list
+result = fast_list.fast_sort([3, 1, 2])
+```
+
+### Classic API
+
 ```python
 from includecpp import CppApi
 
@@ -368,5 +379,5 @@ api.exists("module_name")       # Check if module exists
 ---
 
 **License:** MIT
-**Version:** 2.5.2
+**Version:** 2.6.1
 **Repository:** https://github.com/liliassg/IncludeCPP

{includecpp-2.5.2 → includecpp-2.7.2}/README.md

@@ -80,17 +80,19 @@ includecpp rebuild [OPTIONS]
 ```
 
 **Options:**
-- `--clean` - Force clean rebuild (ignore incremental cache)
-- `--full` - Complete rebuild including generator and all caches
+- `--clean` - Force clean rebuild (delete all cached files)
+- `--keep` - Keep existing generator (skip automatic generator rebuild)
 - `--verbose` - Detailed build output
 - `--no-incremental` - Disable incremental builds
 - `--parallel/--no-parallel` - Enable/disable parallel compilation (default: enabled)
 - `-j, --jobs <N>` - Max parallel jobs (default: 4)
 - `-m, --modules <name>` - Rebuild specific modules only
 
+**Note:** The generator is automatically rebuilt on each run to ensure it's up-to-date. Use `--keep` to skip this if you know the generator is current.
+
 **Examples:**
 ```bash
-includecpp rebuild --full --verbose
+includecpp rebuild --verbose
 includecpp rebuild -m crypto -m networking
 ```
 
@@ -301,6 +303,15 @@ SHA256-based change detection. Only rebuilds modified modules.
 
 ## Python API
 
+### Simple Import (v2.6+)
+
+```python
+from includecpp import fast_list
+result = fast_list.fast_sort([3, 1, 2])
+```
+
+### Classic API
+
 ```python
 from includecpp import CppApi
 
@@ -332,5 +343,5 @@ api.exists("module_name")       # Check if module exists
 ---
 
 **License:** MIT
-**Version:** 2.5.2
+**Version:** 2.6.1
 **Repository:** https://github.com/liliassg/IncludeCPP

includecpp-2.7.2/includecpp/__init__.py

@@ -0,0 +1,58 @@
+from .core.cpp_api import CppApi
+import warnings
+
+__version__ = "2.7.2"
+__all__ = ["CppApi"]
+
+# Module-level cache for C++ modules
+_api_instance = None
+_loaded_modules = {}
+
+def _get_api():
+    """Get or create singleton CppApi instance."""
+    global _api_instance
+    if _api_instance is None:
+        _api_instance = CppApi()
+    return _api_instance
+
+def __getattr__(name: str):
+    """Enable: from includecpp import fast_list
+
+    This hook is called when Python cannot find an attribute in this module.
+    It allows dynamic C++ module loading via the import system.
+    """
+    if name.startswith('_'):
+        raise AttributeError(f"module 'includecpp' has no attribute '{name}'")
+
+    if name in _loaded_modules:
+        return _loaded_modules[name]
+
+    api = _get_api()
+
+    if name not in api.registry:
+        available = list(api.registry.keys())
+        raise AttributeError(
+            f"Module '{name}' not found. "
+            f"Available: {available}. "
+            f"Run 'includecpp rebuild' first."
+        )
+
+    if api.need_update(name):
+        warnings.warn(
+            f"Module '{name}' source files changed. "
+            f"Run 'includecpp rebuild' to update.",
+            UserWarning
+        )
+
+    module = api.include(name)
+    _loaded_modules[name] = module
+    return module
+
+def __dir__():
+    """List available attributes including C++ modules."""
+    base = ['CppApi', '__version__']
+    try:
+        api = _get_api()
+        return sorted(set(base + list(api.registry.keys())))
+    except Exception:
+        return base

{includecpp-2.5.2 → includecpp-2.7.2}/includecpp/__init__.pyi

@@ -2,9 +2,26 @@
 
 from typing import Any, Dict, Optional, List, Literal, overload
 from pathlib import Path
+from types import ModuleType
+
+# 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
 
 __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."""
 

{includecpp-2.5.2 → includecpp-2.7.2}/includecpp/cli/commands.py

@@ -31,7 +31,7 @@ _SEC_TOP = "┌─────────────────────
 _SEC_BOTTOM = "└─────────────────────────────────────────────────────────────┘" if _UNICODE else "+-------------------------------------------------------------+"
 _SEC_SIDE = "│" if _UNICODE else "|"
 _HLINE = "═" if _UNICODE else "-"
-_CHECK = "✓" if _UNICODE else "[OK]"
+_CHECK = ""  # Removed check marks per user request
 _CROSS = "✗" if _UNICODE else "[X]"
 _BULLET = "•" if _UNICODE else "*"
 _ARROW = "→" if _UNICODE else "->"
@@ -49,7 +49,7 @@ def _safe_echo(text, **kwargs):
             ('╔', '+'), ('╗', '+'), ('╚', '+'), ('╝', '+'),
             ('┌', '+'), ('┐', '+'), ('└', '+'), ('┘', '+'),
             ('═', '-'), ('─', '-'), ('║', '|'), ('│', '|'),
-            ('✓', '[OK]'), ('✗', '[X]'), ('•', '*'),
+            ('✗', '[X]'), ('•', '*'),
             ('→', '->'), ('▶', '>'), ('◆', '*')
         ]
         for uni, ascii_char in replacements:
@@ -494,8 +494,11 @@ def _show_build_info_report(build_dir: Path, compiler: str):
             f = first_info['functions'][0]
             first_func = f.get('name', f) if isinstance(f, dict) else f
 
-        click.echo(f"  from {first_mod} import {first_func or 'your_function'}")
-        click.echo(f"  result = {first_func or 'your_function'}(...)")
+        click.echo(f"  from includecpp import CppApi")
+        click.echo(f"  api = CppApi()")
+        click.echo(f"  {first_mod} = api.include(\"{first_mod}\")")
+        if first_func:
+            click.echo(f"  result = {first_mod}.{first_func}(...)")
 
     click.echo("")
     _safe_echo(_HLINE * 64, fg='cyan')
@@ -531,9 +534,61 @@ def _check_for_updates_silent():
         pass  # Silently fail - don't interrupt user's workflow
     return None
 
+
+def _parse_cp_sources(cp_path):
+    """Parse SOURCE() and HEADER() paths from an existing .cp file.
+
+    Returns:
+        Tuple of (source_files, header_files) as lists of Path objects
+    """
+    import re
+    from pathlib import Path
+
+    source_files = []
+    header_files = []
+
+    try:
+        content = cp_path.read_text()
+        project_root = cp_path.parent.parent  # plugins/ -> project root
+
+        # Find SOURCE(...) declarations
+        source_match = re.search(r'SOURCE\s*\(\s*([^)]+)\s*\)', content)
+        if source_match:
+            sources_str = source_match.group(1)
+            # Handle multiple files: SOURCE(file1.cpp file2.cpp) or SOURCE(file1.cpp, file2.cpp)
+            sources = re.split(r'[,\s]+', sources_str.strip())
+            for src in sources:
+                src = src.strip()
+                if src:
+                    p = Path(src)
+                    if not p.is_absolute():
+                        p = project_root / src
+                    if p.exists():
+                        source_files.append(p)
+
+        # Find HEADER(...) declarations
+        header_match = re.search(r'HEADER\s*\(\s*([^)]+)\s*\)', content)
+        if header_match:
+            headers_str = header_match.group(1)
+            headers = re.split(r'[,\s]+', headers_str.strip())
+            for hdr in headers:
+                hdr = hdr.strip()
+                if hdr:
+                    p = Path(hdr)
+                    if not p.is_absolute():
+                        p = project_root / hdr
+                    if p.exists():
+                        header_files.append(p)
+
+    except Exception as e:
+        pass  # Return empty lists on error
+
+    return (source_files, header_files)
+
+
 @cli.command()
 @click.option('--clean', is_flag=True, help='Force clean rebuild (ignore incremental)')
-@click.option('--full', is_flag=True, help='Complete rebuild including plugin_gen.exe and all caches')
+@click.option('--keep', is_flag=True, help='Keep existing plugin_gen.exe (skip generator rebuild)')
 @click.option('--verbose', is_flag=True, help='Verbose output')
 @click.option('--no-incremental', is_flag=True, help='Disable incremental builds')
 @click.option('--incremental', is_flag=True, help='Explicitly enable incremental builds (default: auto)')
@@ -542,14 +597,14 @@ def _check_for_updates_silent():
 @click.option('--modules', '-m', multiple=True, help='Specific modules to rebuild')
 @click.option('--this', 'build_paths', multiple=True, type=click.Path(exists=True),
               help='Build only from specific paths (can specify multiple)')
-@click.option('--fast', 'fast_plugin', type=str, default=None,
-              help='Fast incremental rebuild of single plugin (e.g., algorithms.cp)')
+@click.option('--fast', 'fast_mode', is_flag=True,
+              help='Fast incremental rebuild mode (use with module name, e.g., rebuild --fast gamekit)')
 @click.option('--all', 'fast_all', is_flag=True, help='With --fast: rebuild all plugins incrementally')
 @click.option('--info', is_flag=True, help='Show detailed analysis report of the last build')
 @click.argument('module_args', nargs=-1)
-def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, modules,
-            build_paths, fast_plugin, fast_all, info, module_args):
-    """v2.0: Rebuild C++ modules with incremental and parallel support."""
+def rebuild(clean, keep, verbose, no_incremental, incremental, parallel, jobs, modules,
+            build_paths, fast_mode, fast_all, info, module_args):
+    """Rebuild C++ modules with automatic generator updates."""
     from ..core.build_manager import BuildManager
     from ..core.error_formatter import BuildErrorFormatter, BuildSuccessFormatter
     import time
@@ -599,14 +654,17 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
         _show_build_info_report(build_dir, compiler)
         return
 
-    # Full rebuild: delete everything including generator
-    if full and build_dir.exists():
-        click.echo("Full rebuild: Deleting entire build directory including plugin_gen.exe...")
-        shutil.rmtree(build_dir)
-        clean = True  # Force clean mode
+    # v2.5.4: By default, always delete the generator to ensure it's up-to-date
+    # Use --keep to skip generator rebuild
+    if build_dir.exists():
+        gen_path = build_dir / "bin" / ".appc"
+        if not keep and gen_path.exists():
+            if verbose:
+                click.echo("Removing old generator to force rebuild...")
+            shutil.rmtree(gen_path)
 
-    # Clean if requested
-    elif clean and build_dir.exists():
+    # Clean if requested - delete entire build directory
+    if clean and build_dir.exists():
         click.echo("Cleaning build directory...")
         shutil.rmtree(build_dir)
 
@@ -623,14 +681,28 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
         click.secho("Warning: --clean overrides --incremental", fg='yellow')
         incremental = False
 
-    if fast_plugin and build_paths:
+    if fast_mode and build_paths:
         click.secho("Error: Cannot use both --fast and --this", fg='red', err=True)
         raise click.Abort()
 
-    if fast_all and not fast_plugin:
-        click.secho("Error: --all requires --fast <plugin>", fg='red', err=True)
+    # Validate --all requires --fast
+    if fast_all and not fast_mode:
+        click.secho("Error: --all requires --fast", fg='red', err=True)
         raise click.Abort()
 
+    # Determine fast plugin from modules (positional args or -m option)
+    fast_plugin = None
+    if fast_mode and not fast_all:
+        if modules:
+            fast_plugin = modules[0]  # Use first module from -m option
+        elif module_args:
+            fast_plugin = module_args[0]  # Use first positional argument
+        else:
+            click.secho("Error: --fast requires a module name", fg='red', err=True)
+            click.echo("Usage: includecpp rebuild --fast <module_name>")
+            click.echo("   or: includecpp rebuild -m <module_name> --fast")
+            raise click.Abort()
+
     final_incremental = True
     if incremental:
         final_incremental = True
@@ -694,7 +766,7 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
         if verbose:
             click.echo(f"Affected modules ({len(modules)}): {', '.join(modules)}")
 
-    if fast_all:
+    if fast_mode and fast_all:
         if verbose:
             click.echo("Fast rebuild mode: ALL plugins")
 
@@ -766,12 +838,12 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
             # Print success message
             click.echo("")
             _safe_echo(_BOX_TOP, fg='green')
-            _safe_echo(f"{_BOX_SIDE} {_CHECK} BUILD SUCCESSFUL", fg='green')
+            _safe_echo(f"{_BOX_SIDE} BUILD SUCCESSFUL", fg='green')
             _safe_echo(_BOX_BOTTOM, fg='green')
             click.echo("")
             click.echo(f"Modules built ({len(built_modules)}):")
             for mod in built_modules:
-                _safe_echo(f"  {_CHECK} {mod}", fg='green')
+                _safe_echo(f"  {mod}", fg='green')
             click.echo("")
             click.echo(f"Build time: {build_time:.2f}s")
             if stats:
@@ -782,8 +854,20 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
                 if 'total_structs' in stats:
                     click.echo(f"  Structs exported:   {stats['total_structs']}")
             click.echo("")
-            click.echo("Your modules are ready to use:")
-            click.secho("  from module_name import function_name", fg='cyan')
+            # Show usage with real module name from build
+            if built_modules:
+                first_mod = built_modules[0]
+                first_func = None
+                if first_mod in modules and modules[first_mod].get('functions'):
+                    func_info = modules[first_mod]['functions'][0]
+                    first_func = func_info.get('name', func_info) if isinstance(func_info, dict) else func_info
+
+                click.echo("Usage:")
+                click.echo("  from includecpp import CppApi")
+                click.echo("  api = CppApi()")
+                click.echo(f"  {first_mod} = api.include(\"{first_mod}\")")
+                if first_func:
+                    click.echo(f"  result = {first_mod}.{first_func}(...)")
             click.echo("")
         else:
             click.echo("")
@@ -803,13 +887,9 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
     except Exception as e:
         build_time = time.time() - start_time
         error_msg = str(e)
+        module_name = target_modules[0] if target_modules else ""
 
-        # v2.4.1: Use analyze_error for intelligent error formatting
-        formatted_error = BuildErrorFormatter.analyze_error(error_msg, target_modules[0] if target_modules else "")
-
-        click.echo("")
-        click.secho(formatted_error, fg='red', err=True)
-
+        # v2.7: Print verbose details FIRST (for those who read everything)
         if verbose:
             click.echo("")
             _safe_echo(_HLINE * 60, fg='yellow')
@@ -817,9 +897,43 @@ def rebuild(clean, full, verbose, no_incremental, incremental, parallel, jobs, m
             _safe_echo(_HLINE * 60, fg='yellow')
             import traceback
             traceback.print_exc()
+            click.echo("")
+
+        # v2.7: Print detailed error analysis
+        formatted_error = BuildErrorFormatter.analyze_error(error_msg, module_name)
+        click.echo("")
+        click.secho(formatted_error, fg='red', err=True)
+
+        # v2.7: Print short helpful message LAST (for lazy users who only read the end)
+        final_msg = BuildErrorFormatter.get_final_message(error_msg, module_name)
+        click.echo("")
+        click.secho(final_msg, fg='red', bold=True, err=True)
 
         raise click.Abort()
 
+@cli.command()
+@click.option('--clean', is_flag=True, help='Force clean rebuild')
+@click.option('--keep', is_flag=True, help='Keep existing plugin_gen.exe')
+@click.option('-v', '--verbose', is_flag=True, help='Show detailed output')
+@click.option('--no-incremental', is_flag=True, help='Disable incremental builds')
+@click.option('--incremental', is_flag=True, help='Force incremental build')
+@click.option('--parallel', is_flag=True, help='Build modules in parallel')
+@click.option('-j', '--jobs', type=int, default=None, help='Number of parallel jobs')
+@click.option('-m', '--modules', multiple=True, help='Specific modules to build')
+@click.option('--this', 'build_paths', multiple=True, type=click.Path(exists=True), help='Build from path')
+@click.option('--fast', 'fast_mode', is_flag=True, help='Fast incremental build')
+@click.option('--all', 'fast_all', is_flag=True, help='With --fast: rebuild all plugins')
+@click.option('--info', is_flag=True, help='Show build analysis report')
+@click.argument('module_args', nargs=-1)
+@click.pass_context
+def build(ctx, clean, keep, verbose, no_incremental, incremental, parallel, jobs, modules,
+          build_paths, fast_mode, fast_all, info, module_args):
+    """Build C++ modules (alias for rebuild)."""
+    ctx.invoke(rebuild, clean=clean, keep=keep, verbose=verbose, no_incremental=no_incremental,
+               incremental=incremental, parallel=parallel, jobs=jobs, modules=modules,
+               build_paths=build_paths, fast_mode=fast_mode, fast_all=fast_all, info=info,
+               module_args=module_args)
+
 @cli.command()
 @click.argument('module_name')
 def add(module_name):
@@ -847,8 +961,8 @@ PUBLIC(
     click.echo(f"Created {cp_file}")
     click.echo(f"Now create include/{module_name}.cpp with your C++ code")
 
-@cli.command()
-def list():
+@cli.command('list')
+def list_modules():
     """List all available C++ modules."""
     from ..core.build_manager import BuildManager
 
@@ -1707,12 +1821,22 @@ def reboot():
 
 @cli.command()
 @click.argument('plugin_name')
-@click.argument('files', nargs=-1, required=True)
+@click.argument('files', nargs=-1, required=False)
 @click.option('--private', '-p', multiple=True, help='Private functions to exclude from public API')
 def plugin(plugin_name, files, private):
+    """Generate or regenerate a .cp plugin definition from C++ source files.
+
+    If no files are provided and an existing .cp file exists, SOURCE() and HEADER()
+    paths are read from it to auto-regenerate the plugin definition.
+    """
     import re
     from pathlib import Path
 
+    # Normalize plugin_name: strip .cp extension and path prefixes
+    if plugin_name.endswith('.cp'):
+        plugin_name = plugin_name[:-3]
+    plugin_name = Path(plugin_name).stem
+
     project_root = Path.cwd()
     plugins_dir = project_root / "plugins"
 
@@ -1721,6 +1845,24 @@ def plugin(plugin_name, files, private):
         click.echo("Run 'python -m includecpp init' first")
         return
 
+    # v2.5.3: Auto-regenerate from existing .cp file if no files provided
+    if not files:
+        existing_cp = plugins_dir / f"{plugin_name}.cp"
+        if existing_cp.exists():
+            click.echo(f"Auto-regenerating from existing: {existing_cp}")
+            source_files, header_files = _parse_cp_sources(existing_cp)
+            if not source_files:
+                click.secho("Error: No SOURCE() found in existing .cp file", fg='red', err=True)
+                click.echo("Usage: includecpp plugin <name> <file1.cpp> [file2.h] ...")
+                return
+            # Combine and use as input files
+            files = tuple(source_files + header_files)
+            click.echo(f"Found sources: {', '.join(str(f) for f in files)}")
+        else:
+            click.secho("Error: No files provided and no existing .cp file found", fg='red', err=True)
+            click.echo("Usage: includecpp plugin <name> <file1.cpp> [file2.h] ...")
+            return
+
     cpp_files = []
     h_files = []
 
@@ -2329,11 +2471,28 @@ def bug(message, get_bugs):
 
     click.echo("=" * 60)
 
-def detect_compiler():
+# Compiler detection cache
+_compiler_cache = None
+
+def detect_compiler(force_refresh=False):
+    """Detect available C++ compiler with caching.
+
+    Checks g++ first per user requirement, then clang++, then cl (MSVC).
+    Results are cached to avoid repeated PATH scans.
+    """
+    global _compiler_cache
+
+    if not force_refresh and _compiler_cache is not None:
+        return _compiler_cache
+
+    # g++ first (user requirement)
     for compiler in ['g++', 'clang++', 'cl']:
         if shutil.which(compiler):
-            return compiler.replace('++', '').replace('cl', 'msvc')
-    return 'gcc'
+            _compiler_cache = compiler.replace('++', '').replace('cl', 'msvc')
+            return _compiler_cache
+
+    _compiler_cache = 'gcc'
+    return _compiler_cache
 
 if __name__ == '__main__':
     cli()