IncludeCPP 3.7.3__py3-none-any.whl

includecpp/core/exceptions.py

@@ -0,0 +1,97 @@
+"""Exception hierarchy for C++ API system.
+
+This module defines all custom exceptions used by the C++ API dynamic module system.
+All exceptions inherit from CppApiError for easy catching of all API-related errors.
+"""
+
+
+class CppApiError(Exception):
+    """Base exception for all C++ API errors.
+
+    All custom exceptions in the C++ API system inherit from this base class,
+    allowing users to catch all API-related errors with a single except clause.
+    """
+    pass
+
+
+class CppBuildError(CppApiError):
+    """Build or compilation failed.
+
+    Raised when:
+    - CMake configuration fails
+    - C++ compilation fails
+    - Plugin generator compilation fails
+    - Build process times out
+    - Build script not found
+    """
+    pass
+
+
+class CppModuleNotFoundError(CppApiError):
+    """Requested module not found in registry.
+
+    Raised when:
+    - include() called with non-existent module name
+    - Module not registered in .module_registry.json
+    - .cp file missing for requested module
+    """
+    pass
+
+
+class CppModuleOutdatedError(CppApiError):
+    """Module source files changed since last build.
+
+    Raised when:
+    - Source file hash mismatch detected
+    - Header file hash mismatch detected
+    - .cp file hash mismatch detected
+    - auto_update=False and module is outdated
+    """
+    pass
+
+
+class CppReloadWarning(UserWarning):
+    """Warning about unsafe C extension reload.
+
+    This warning is issued when:
+    - rebuild() called but api module already loaded
+    - User needs to restart Python to use new version
+    - C extension hot-reload attempted (unsafe)
+    """
+    pass
+
+
+class CppValidationError(CppApiError):
+    """Generated code validation failed.
+
+    Raised when:
+    - Generated pybind11 code has syntax errors
+    - Unbalanced braces detected
+    - Missing required includes
+    - Invalid generated code structure
+    """
+    pass
+
+
+class CppParseError(CppApiError):
+    """.cp file parsing failed.
+
+    Raised when:
+    - Malformed .cp file syntax
+    - Invalid module name
+    - Missing parentheses in FUNC/CLASS/VAR
+    - Invalid syntax in PUBLIC() block
+    """
+    pass
+
+
+class CppGeneratorError(CppApiError):
+    """Plugin generator failed.
+
+    Raised when:
+    - Generator executable not found
+    - Generator process crashed
+    - Generator output invalid
+    - Generator version mismatch
+    """
+    pass

includecpp/core/path_discovery.py

@@ -0,0 +1,77 @@
+"""Path discovery module for finding C++ modules in specific directories."""
+
+import os
+from pathlib import Path
+from typing import List, Set
+
+
+class PathDiscovery:
+    """Discover C++ modules (.cp files) in specific paths."""
+
+    def __init__(self, project_root: Path, config):
+        self.project_root = project_root
+        self.config = config
+        self.plugins_dir = config.resolve_path(config.config.get('plugins', '/plugins'))
+
+    def discover_modules_in_path(self, search_path: Path) -> List[str]:
+        """Discover module names from .cp files in given path.
+
+        Args:
+            search_path: Directory or file path to search
+
+        Returns:
+            List of module names (without .cp extension)
+        """
+        modules = []
+
+        if not search_path.is_absolute():
+            search_path = (self.project_root / search_path).resolve()
+
+        if search_path.is_file():
+            if search_path.suffix == '.cp':
+                module_name = search_path.stem
+                modules.append(module_name)
+            return modules
+
+        if search_path.is_dir():
+            for cp_file in search_path.glob('*.cp'):
+                module_name = cp_file.stem
+                modules.append(module_name)
+
+            cpp_files = list(search_path.glob('*.cpp'))
+            h_files = list(search_path.glob('*.h'))
+
+            for cpp_file in cpp_files:
+                potential_cp = self.plugins_dir / f"{cpp_file.stem}.cp"
+                if potential_cp.exists() and cpp_file.stem not in modules:
+                    modules.append(cpp_file.stem)
+
+            for h_file in h_files:
+                potential_cp = self.plugins_dir / f"{h_file.stem}.cp"
+                if potential_cp.exists() and h_file.stem not in modules:
+                    modules.append(h_file.stem)
+
+        return modules
+
+    def find_cp_files_in_paths(self, paths: List[Path]) -> Set[Path]:
+        """Find all .cp files in given paths.
+
+        Args:
+            paths: List of directories or files to search
+
+        Returns:
+            Set of .cp file paths
+        """
+        cp_files = set()
+
+        for path in paths:
+            if not path.is_absolute():
+                path = (self.project_root / path).resolve()
+
+            if path.is_file() and path.suffix == '.cp':
+                cp_files.add(path)
+            elif path.is_dir():
+                for cp_file in path.glob('*.cp'):
+                    cp_files.add(cp_file)
+
+        return cp_files