IncludeCPP 4.6.6__tar.gz → 4.6.9__tar.gz

{includecpp-4.6.6 → includecpp-4.6.9}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.6.6
+Version: 4.6.9
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -179,6 +179,11 @@ includecpp rebuild --clean
 | `rebuild --fast` | Fast incremental build |
 | `rebuild --clean` | Full clean rebuild |
 | `get <name>` | Show module's API |
+| `server start` | Start HomeServer |
+| `server stop` | Stop HomeServer |
+| `server upload` | Upload file/project |
+| `server download` | Download file/project |
+| `server list` | List stored items |
 
 ---
 
@@ -247,6 +252,39 @@ includecpp <command> --help
 
 ---
 
+## HomeServer
+
+Store and manage your modules, projects and files locally with the HomeServer:
+
+```bash
+# Install and start the server (one-time setup)
+includecpp server install
+
+# Manual start/stop
+includecpp server start
+includecpp server stop
+includecpp server status
+
+# Upload files or projects
+includecpp server upload mymodule ./include/mymodule.cpp
+includecpp server upload myproject ./myproject --project
+
+# List, download, delete
+includecpp server list
+includecpp server download mymodule ./backup/
+includecpp server delete mymodule
+
+# Change port (default: 2007)
+includecpp server port 3000
+
+# Remove HomeServer completely
+includecpp server deinstall
+```
+
+The server runs silently in the background and can auto-start with Windows.
+
+---
+
 ## Experimental Features
 
 IncludeCPP also includes experimental features that are still in development:

{includecpp-4.6.6 → includecpp-4.6.9}/IncludeCPP.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ setup.py
 ./includecpp/core/error_catalog.py
 ./includecpp/core/error_formatter.py
 ./includecpp/core/exceptions.py
+./includecpp/core/homeserver.py
 ./includecpp/core/path_discovery.py
 ./includecpp/core/project_ui.py
 ./includecpp/core/settings_ui.py
@@ -91,6 +92,7 @@ includecpp/core/cssl_bridge.pyi
 includecpp/core/error_catalog.py
 includecpp/core/error_formatter.py
 includecpp/core/exceptions.py
+includecpp/core/homeserver.py
 includecpp/core/path_discovery.py
 includecpp/core/project_ui.py
 includecpp/core/settings_ui.py

{includecpp-4.6.6 → includecpp-4.6.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.6.6
+Version: 4.6.9
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -179,6 +179,11 @@ includecpp rebuild --clean
 | `rebuild --fast` | Fast incremental build |
 | `rebuild --clean` | Full clean rebuild |
 | `get <name>` | Show module's API |
+| `server start` | Start HomeServer |
+| `server stop` | Stop HomeServer |
+| `server upload` | Upload file/project |
+| `server download` | Download file/project |
+| `server list` | List stored items |
 
 ---
 
@@ -247,6 +252,39 @@ includecpp <command> --help
 
 ---
 
+## HomeServer
+
+Store and manage your modules, projects and files locally with the HomeServer:
+
+```bash
+# Install and start the server (one-time setup)
+includecpp server install
+
+# Manual start/stop
+includecpp server start
+includecpp server stop
+includecpp server status
+
+# Upload files or projects
+includecpp server upload mymodule ./include/mymodule.cpp
+includecpp server upload myproject ./myproject --project
+
+# List, download, delete
+includecpp server list
+includecpp server download mymodule ./backup/
+includecpp server delete mymodule
+
+# Change port (default: 2007)
+includecpp server port 3000
+
+# Remove HomeServer completely
+includecpp server deinstall
+```
+
+The server runs silently in the background and can auto-start with Windows.
+
+---
+
 ## Experimental Features
 
 IncludeCPP also includes experimental features that are still in development:

{includecpp-4.6.6 → includecpp-4.6.9}/README.md

@@ -144,6 +144,11 @@ includecpp rebuild --clean
 | `rebuild --fast` | Fast incremental build |
 | `rebuild --clean` | Full clean rebuild |
 | `get <name>` | Show module's API |
+| `server start` | Start HomeServer |
+| `server stop` | Stop HomeServer |
+| `server upload` | Upload file/project |
+| `server download` | Download file/project |
+| `server list` | List stored items |
 
 ---
 
@@ -212,6 +217,39 @@ includecpp <command> --help
 
 ---
 
+## HomeServer
+
+Store and manage your modules, projects and files locally with the HomeServer:
+
+```bash
+# Install and start the server (one-time setup)
+includecpp server install
+
+# Manual start/stop
+includecpp server start
+includecpp server stop
+includecpp server status
+
+# Upload files or projects
+includecpp server upload mymodule ./include/mymodule.cpp
+includecpp server upload myproject ./myproject --project
+
+# List, download, delete
+includecpp server list
+includecpp server download mymodule ./backup/
+includecpp server delete mymodule
+
+# Change port (default: 2007)
+includecpp server port 3000
+
+# Remove HomeServer completely
+includecpp server deinstall
+```
+
+The server runs silently in the background and can auto-start with Windows.
+
+---
+
 ## Experimental Features
 
 IncludeCPP also includes experimental features that are still in development:

{includecpp-4.6.6 → includecpp-4.6.9}/includecpp/CHANGELOG.md

@@ -1,5 +1,24 @@
 # IncludeCPP Changelog
 
+## v4.6.7 (2026-01-14)
+
+### New Features
+- **HomeServer**: Local storage server for modules, projects and files
+  - `includecpp server install` - Install and auto-start HomeServer
+  - `includecpp server start/stop` - Manual server control
+  - `includecpp server status` - Check server status
+  - `includecpp server upload/download` - File and project management
+  - `includecpp server list` - List stored items
+  - `includecpp server delete` - Remove items
+  - `includecpp server port` - Change server port
+  - `includecpp server deinstall` - Remove HomeServer completely
+- Server runs in background (no terminal window)
+- Auto-start support on Windows
+- SQLite database for metadata storage
+- Default port: 2007
+
+---
+
 ## v4.6.6 (2026-01-14)
 
 ### New Features

includecpp-4.6.9/includecpp/__init__.py

@@ -0,0 +1,105 @@
+from .core.cpp_api import CppApi
+from .core import cssl_bridge as CSSL
+import warnings
+import os
+import sys
+from pathlib import Path
+
+__version__ = "4.6.9"
+__all__ = ["CppApi", "CSSL"]
+
+# Module-level cache for C++ modules
+_api_instance = None
+_loaded_modules = {}
+_frozen_api = None  # Cached API module for frozen (PyInstaller) mode
+
+def _is_frozen():
+    """Check if running in a frozen PyInstaller bundle."""
+    return getattr(sys, 'frozen', False)
+
+def _get_frozen_api():
+    """Get the bundled API module when running frozen."""
+    global _frozen_api
+    if _frozen_api is None:
+        try:
+            import api
+            _frozen_api = api
+        except ImportError:
+            _frozen_api = False  # Mark as not available
+    return _frozen_api if _frozen_api else None
+
+def _get_api():
+    """Get or create singleton CppApi instance.
+
+    Checks INCLUDECPP_PROJECT env var for project path when running
+    from a different directory (e.g., via 'includecpp server run').
+    """
+    global _api_instance
+    if _api_instance is None:
+        # Check for project path from environment (set by 'server run -p')
+        project_path = os.environ.get('INCLUDECPP_PROJECT')
+        if project_path:
+            config_path = Path(project_path) / 'cpp.proj'
+            if config_path.exists():
+                _api_instance = CppApi(config_path=config_path)
+            else:
+                _api_instance = CppApi()
+        else:
+            _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]
+
+    # In frozen mode (PyInstaller), try to get module from bundled api
+    if _is_frozen():
+        frozen_api = _get_frozen_api()
+        if frozen_api and hasattr(frozen_api, name):
+            module = getattr(frozen_api, name)
+            _loaded_modules[name] = module
+            return module
+        # If not found in frozen api, raise helpful error
+        raise AttributeError(
+            f"Module '{name}' not found in bundled executable. "
+            f"Ensure it was included during build with 'includecpp --make-exe'."
+        )
+
+    # Normal mode: use CppApi
+    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', 'CSSL', '__version__']
+    try:
+        api = _get_api()
+        return sorted(set(base + list(api.registry.keys())))
+    except Exception:
+        return base