IncludeCPP 1.2.1__tar.gz

includecpp-1.2.1/IncludeCPP.egg-info/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: IncludeCPP
+Version: 1.2.1
+Summary: Professional C++ Python bindings with type-generic templates and native threading
+Home-page: https://github.com/includecpp/includecpp
+Author: IncludeCPP Team
+Author-email: IncludeCPP Team <contact@includecpp.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/includecpp/includecpp
+Project-URL: Documentation, https://includecpp.readthedocs.io
+Project-URL: Repository, https://github.com/includecpp/includecpp
+Project-URL: Bug Tracker, https://github.com/includecpp/includecpp/issues
+Keywords: c++,python,bindings,pybind11,template,performance,threading
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: C++
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pybind11>=2.11.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# IncludeCPP - Professional C++ Python Bindings
+
+Professional C++ ↔ Python binding system with type-generic templates, native threading support, and maximum performance.
+
+## Features
+
+- **Type-Generic System**: Functions work with ANY type automatically
+  ```python
+  algorithms.fast_sort([1,2,3])      # int version
+  algorithms.fast_sort([1.5, 2.3])   # float version
+  algorithms.fast_sort(["a","b"])    # string version
+  ```
+
+- **Native Threading with GIL Release**: True parallelism
+  ```python
+  game = CPP.include("threading").GameEngine()
+  CPP.threadThis(game)  # Runs in C++ thread with GIL released
+  ```
+
+- **Dynamic Configuration**: `cpp.proj` JSON configuration
+- **AppData Build System**: Clean separation of project and build artifacts
+- **CLI Tool**: `includecpp --rebuild` for easy building
+- **Zero Overhead**: Template instantiation eliminates runtime overhead
+
+## Installation
+
+```bash
+pip install IncludeCPP
+```
+
+## Quick Start
+
+### 1. Initialize Project
+
+```bash
+cd YourProject
+includecpp init
+```
+
+This creates:
+- `cpp.proj` - Configuration file
+- `include/` - Your C++ source files
+- `plugins/` - Plugin definitions (.cp files)
+
+### 2. Create C++ Module
+
+**include/mymodule.cpp**:
+```cpp
+#include <vector>
+#include <algorithm>
+
+namespace includecpp {
+
+std::vector<int> custom_sort(const std::vector<int>& data) {
+    std::vector<int> result = data;
+    std::sort(result.begin(), result.end());
+    return result;
+}
+
+}
+```
+
+**plugins/mymodule.cp**:
+```
+SOURCE(include/mymodule.cpp) mymodule
+
+PUBLIC(
+    mymodule FUNC(custom_sort)
+)
+```
+
+### 3. Build
+
+```bash
+includecpp --rebuild
+```
+
+Build artifacts go to:
+- **Windows**: `%APPDATA%/YourProject&gcc-build-proj/`
+- **Linux**: `~/.local/share/includecpp/YourProject&gcc-build-proj/`
+
+### 4. Use in Python
+
+```python
+import IncludeCPP as cpp
+
+CPP = cpp.CppApi()
+CPP.noFeedback()  # Disable warnings
+
+mymodule = CPP.include("mymodule")
+result = mymodule.custom_sort([5, 2, 9, 1])
+print(result)  # [1, 2, 5, 9]
+```
+
+## Type-Generic Templates
+
+```python
+# plugins/algorithms.cp
+SOURCE(include/algorithms.cpp) && HEADER(include/algorithms.h) algorithms
+
+PUBLIC(
+    algorithms TEMPLATE_FUNC(fast_sort) TYPES(int, float, double, string)
+)
+```
+
+## Configuration
+
+**cpp.proj** (auto-created by `includecpp init`):
+```json
+{
+  "project": "MyProject",
+  "version": "1.0.0",
+  "include": "/include",
+  "plugins": "/plugins",
+  "compiler": {
+    "standard": "c++17",
+    "optimization": "O3",
+    "flags": ["-Wall", "-pthread"]
+  }
+}
+```
+
+## Requirements
+
+- Python >= 3.8
+- C++ compiler (g++, clang++, or MSVC)
+- pybind11 >= 2.11.0
+- CMake >= 3.15
+
+## License
+
+MIT License
+
+## Links
+
+- **Documentation**: https://includecpp.readthedocs.io
+- **GitHub**: https://github.com/includecpp/includecpp
+- **PyPI**: https://pypi.org/project/IncludeCPP
+
+## Example: Complete Module
+
+See the `examples/` directory for complete working examples including:
+- Type-generic algorithms
+- Threading with GIL release
+- Map and Array containers
+- Custom C++ classes

includecpp-1.2.1/IncludeCPP.egg-info/SOURCES.txt

@@ -0,0 +1,38 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+requirements.txt
+setup.py
+./includecpp/__init__.py
+./includecpp/__main__.py
+./includecpp/cli/__init__.py
+./includecpp/cli/commands.py
+./includecpp/cli/config_parser.py
+./includecpp/core/__init__.py
+./includecpp/core/build_manager.py
+./includecpp/core/cpp_api.py
+./includecpp/core/exceptions.py
+./includecpp/generator/__init__.py
+./includecpp/generator/parser.cpp
+./includecpp/generator/parser.h
+./includecpp/templates/cpp.proj.template
+IncludeCPP.egg-info/PKG-INFO
+IncludeCPP.egg-info/SOURCES.txt
+IncludeCPP.egg-info/dependency_links.txt
+IncludeCPP.egg-info/entry_points.txt
+IncludeCPP.egg-info/requires.txt
+IncludeCPP.egg-info/top_level.txt
+includecpp/__init__.py
+includecpp/__main__.py
+includecpp/cli/__init__.py
+includecpp/cli/commands.py
+includecpp/cli/config_parser.py
+includecpp/core/__init__.py
+includecpp/core/build_manager.py
+includecpp/core/cpp_api.py
+includecpp/core/exceptions.py
+includecpp/generator/__init__.py
+includecpp/generator/parser.cpp
+includecpp/generator/parser.h
+includecpp/templates/cpp.proj.template

includecpp-1.2.1/IncludeCPP.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

includecpp-1.2.1/IncludeCPP.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+includecpp = includecpp.cli.commands:cli

includecpp-1.2.1/IncludeCPP.egg-info/requires.txt

@@ -0,0 +1,3 @@
+pybind11>=2.11.0
+click>=8.0.0
+typing-extensions>=4.0.0

includecpp-1.2.1/IncludeCPP.egg-info/top_level.txt

@@ -0,0 +1 @@
+includecpp

includecpp-1.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 IncludeCPP Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

includecpp-1.2.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include includecpp/templates *
+recursive-include includecpp/generator *.cpp *.h
+recursive-include includecpp *.py

includecpp-1.2.1/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: IncludeCPP
+Version: 1.2.1
+Summary: Professional C++ Python bindings with type-generic templates and native threading
+Home-page: https://github.com/includecpp/includecpp
+Author: IncludeCPP Team
+Author-email: IncludeCPP Team <contact@includecpp.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/includecpp/includecpp
+Project-URL: Documentation, https://includecpp.readthedocs.io
+Project-URL: Repository, https://github.com/includecpp/includecpp
+Project-URL: Bug Tracker, https://github.com/includecpp/includecpp/issues
+Keywords: c++,python,bindings,pybind11,template,performance,threading
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: C++
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pybind11>=2.11.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# IncludeCPP - Professional C++ Python Bindings
+
+Professional C++ ↔ Python binding system with type-generic templates, native threading support, and maximum performance.
+
+## Features
+
+- **Type-Generic System**: Functions work with ANY type automatically
+  ```python
+  algorithms.fast_sort([1,2,3])      # int version
+  algorithms.fast_sort([1.5, 2.3])   # float version
+  algorithms.fast_sort(["a","b"])    # string version
+  ```
+
+- **Native Threading with GIL Release**: True parallelism
+  ```python
+  game = CPP.include("threading").GameEngine()
+  CPP.threadThis(game)  # Runs in C++ thread with GIL released
+  ```
+
+- **Dynamic Configuration**: `cpp.proj` JSON configuration
+- **AppData Build System**: Clean separation of project and build artifacts
+- **CLI Tool**: `includecpp --rebuild` for easy building
+- **Zero Overhead**: Template instantiation eliminates runtime overhead
+
+## Installation
+
+```bash
+pip install IncludeCPP
+```
+
+## Quick Start
+
+### 1. Initialize Project
+
+```bash
+cd YourProject
+includecpp init
+```
+
+This creates:
+- `cpp.proj` - Configuration file
+- `include/` - Your C++ source files
+- `plugins/` - Plugin definitions (.cp files)
+
+### 2. Create C++ Module
+
+**include/mymodule.cpp**:
+```cpp
+#include <vector>
+#include <algorithm>
+
+namespace includecpp {
+
+std::vector<int> custom_sort(const std::vector<int>& data) {
+    std::vector<int> result = data;
+    std::sort(result.begin(), result.end());
+    return result;
+}
+
+}
+```
+
+**plugins/mymodule.cp**:
+```
+SOURCE(include/mymodule.cpp) mymodule
+
+PUBLIC(
+    mymodule FUNC(custom_sort)
+)
+```
+
+### 3. Build
+
+```bash
+includecpp --rebuild
+```
+
+Build artifacts go to:
+- **Windows**: `%APPDATA%/YourProject&gcc-build-proj/`
+- **Linux**: `~/.local/share/includecpp/YourProject&gcc-build-proj/`
+
+### 4. Use in Python
+
+```python
+import IncludeCPP as cpp
+
+CPP = cpp.CppApi()
+CPP.noFeedback()  # Disable warnings
+
+mymodule = CPP.include("mymodule")
+result = mymodule.custom_sort([5, 2, 9, 1])
+print(result)  # [1, 2, 5, 9]
+```
+
+## Type-Generic Templates
+
+```python
+# plugins/algorithms.cp
+SOURCE(include/algorithms.cpp) && HEADER(include/algorithms.h) algorithms
+
+PUBLIC(
+    algorithms TEMPLATE_FUNC(fast_sort) TYPES(int, float, double, string)
+)
+```
+
+## Configuration
+
+**cpp.proj** (auto-created by `includecpp init`):
+```json
+{
+  "project": "MyProject",
+  "version": "1.0.0",
+  "include": "/include",
+  "plugins": "/plugins",
+  "compiler": {
+    "standard": "c++17",
+    "optimization": "O3",
+    "flags": ["-Wall", "-pthread"]
+  }
+}
+```
+
+## Requirements
+
+- Python >= 3.8
+- C++ compiler (g++, clang++, or MSVC)
+- pybind11 >= 2.11.0
+- CMake >= 3.15
+
+## License
+
+MIT License
+
+## Links
+
+- **Documentation**: https://includecpp.readthedocs.io
+- **GitHub**: https://github.com/includecpp/includecpp
+- **PyPI**: https://pypi.org/project/IncludeCPP
+
+## Example: Complete Module
+
+See the `examples/` directory for complete working examples including:
+- Type-generic algorithms
+- Threading with GIL release
+- Map and Array containers
+- Custom C++ classes

includecpp-1.2.1/README.md

@@ -0,0 +1,146 @@
+# IncludeCPP - Professional C++ Python Bindings
+
+Professional C++ ↔ Python binding system with type-generic templates, native threading support, and maximum performance.
+
+## Features
+
+- **Type-Generic System**: Functions work with ANY type automatically
+  ```python
+  algorithms.fast_sort([1,2,3])      # int version
+  algorithms.fast_sort([1.5, 2.3])   # float version
+  algorithms.fast_sort(["a","b"])    # string version
+  ```
+
+- **Native Threading with GIL Release**: True parallelism
+  ```python
+  game = CPP.include("threading").GameEngine()
+  CPP.threadThis(game)  # Runs in C++ thread with GIL released
+  ```
+
+- **Dynamic Configuration**: `cpp.proj` JSON configuration
+- **AppData Build System**: Clean separation of project and build artifacts
+- **CLI Tool**: `includecpp --rebuild` for easy building
+- **Zero Overhead**: Template instantiation eliminates runtime overhead
+
+## Installation
+
+```bash
+pip install IncludeCPP
+```
+
+## Quick Start
+
+### 1. Initialize Project
+
+```bash
+cd YourProject
+includecpp init
+```
+
+This creates:
+- `cpp.proj` - Configuration file
+- `include/` - Your C++ source files
+- `plugins/` - Plugin definitions (.cp files)
+
+### 2. Create C++ Module
+
+**include/mymodule.cpp**:
+```cpp
+#include <vector>
+#include <algorithm>
+
+namespace includecpp {
+
+std::vector<int> custom_sort(const std::vector<int>& data) {
+    std::vector<int> result = data;
+    std::sort(result.begin(), result.end());
+    return result;
+}
+
+}
+```
+
+**plugins/mymodule.cp**:
+```
+SOURCE(include/mymodule.cpp) mymodule
+
+PUBLIC(
+    mymodule FUNC(custom_sort)
+)
+```
+
+### 3. Build
+
+```bash
+includecpp --rebuild
+```
+
+Build artifacts go to:
+- **Windows**: `%APPDATA%/YourProject&gcc-build-proj/`
+- **Linux**: `~/.local/share/includecpp/YourProject&gcc-build-proj/`
+
+### 4. Use in Python
+
+```python
+import IncludeCPP as cpp
+
+CPP = cpp.CppApi()
+CPP.noFeedback()  # Disable warnings
+
+mymodule = CPP.include("mymodule")
+result = mymodule.custom_sort([5, 2, 9, 1])
+print(result)  # [1, 2, 5, 9]
+```
+
+## Type-Generic Templates
+
+```python
+# plugins/algorithms.cp
+SOURCE(include/algorithms.cpp) && HEADER(include/algorithms.h) algorithms
+
+PUBLIC(
+    algorithms TEMPLATE_FUNC(fast_sort) TYPES(int, float, double, string)
+)
+```
+
+## Configuration
+
+**cpp.proj** (auto-created by `includecpp init`):
+```json
+{
+  "project": "MyProject",
+  "version": "1.0.0",
+  "include": "/include",
+  "plugins": "/plugins",
+  "compiler": {
+    "standard": "c++17",
+    "optimization": "O3",
+    "flags": ["-Wall", "-pthread"]
+  }
+}
+```
+
+## Requirements
+
+- Python >= 3.8
+- C++ compiler (g++, clang++, or MSVC)
+- pybind11 >= 2.11.0
+- CMake >= 3.15
+
+## License
+
+MIT License
+
+## Links
+
+- **Documentation**: https://includecpp.readthedocs.io
+- **GitHub**: https://github.com/includecpp/includecpp
+- **PyPI**: https://pypi.org/project/IncludeCPP
+
+## Example: Complete Module
+
+See the `examples/` directory for complete working examples including:
+- Type-generic algorithms
+- Threading with GIL release
+- Map and Array containers
+- Custom C++ classes

includecpp-1.2.1/includecpp/__init__.py

@@ -0,0 +1,4 @@
+from .core.cpp_api import CppApi
+
+__version__ = "1.1.0"
+__all__ = ["CppApi"]

includecpp-1.2.1/includecpp/__main__.py

@@ -0,0 +1,4 @@
+from .cli.commands import cli
+
+if __name__ == "__main__":
+    cli()

includecpp-1.2.1/includecpp/cli/__init__.py

@@ -0,0 +1,4 @@
+from .commands import cli
+from .config_parser import CppProjectConfig
+
+__all__ = ["cli", "CppProjectConfig"]

includecpp-1.2.1/includecpp/cli/commands.py

@@ -0,0 +1,85 @@
+import click
+import subprocess
+import shutil
+from pathlib import Path
+from .config_parser import CppProjectConfig
+
+@click.group()
+def cli():
+    pass
+
+@cli.command()
+def init():
+    config_file = Path.cwd() / "cpp.proj"
+    if config_file.exists():
+        click.echo("cpp.proj already exists")
+        return
+
+    CppProjectConfig.create_default('cpp.proj')
+    click.echo("Created cpp.proj configuration")
+    click.echo("Created include/ directory")
+    click.echo("Created plugins/ directory")
+
+@cli.command()
+@click.option('--clean', is_flag=True, help='Clean build artifacts first')
+@click.option('--verbose', is_flag=True, help='Verbose output')
+def rebuild(clean, verbose):
+    from ..core.build_manager import BuildManager
+
+    project_root = Path.cwd()
+    config = CppProjectConfig()
+
+    compiler = detect_compiler()
+    build_dir = config.get_build_dir(compiler)
+
+    if clean and build_dir.exists():
+        shutil.rmtree(build_dir)
+
+    build_dir.mkdir(parents=True, exist_ok=True)
+    config.update_base_dir(build_dir)
+
+    click.echo(f"Build directory: {build_dir}")
+    click.echo("Building C++ modules...")
+
+    try:
+        builder = BuildManager(project_root, build_dir, config)
+        builder.rebuild_all(verbose=verbose)
+        click.echo("\nBuild completed successfully!")
+    except Exception as e:
+        click.echo(f"\nBuild failed: {e}", err=True)
+        raise click.Abort()
+
+@cli.command()
+@click.argument('module_name')
+def add(module_name):
+    plugins_dir = Path("plugins")
+    if not plugins_dir.exists():
+        click.echo("Error: plugins/ directory not found")
+        return
+
+    cp_file = plugins_dir / f"{module_name}.cp"
+    if cp_file.exists():
+        click.echo(f"Module {module_name} already exists")
+        return
+
+    template = f"""SOURCE(include/{module_name}.cpp) && HEADER(include/{module_name}.h) {module_name}
+
+PUBLIC(
+    ALL
+)
+"""
+
+    with open(cp_file, 'w') as f:
+        f.write(template)
+
+    click.echo(f"Created {cp_file}")
+    click.echo(f"Now create include/{module_name}.cpp and include/{module_name}.h")
+
+def detect_compiler():
+    for compiler in ['g++', 'clang++', 'cl']:
+        if shutil.which(compiler):
+            return compiler.replace('++', '').replace('cl', 'msvc')
+    return 'gcc'
+
+if __name__ == '__main__':
+    cli()