IncludeCPP 3.9.1__tar.gz → 4.2.2__tar.gz

{includecpp-3.9.1 → includecpp-4.2.2/IncludeCPP.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.9.1
+Version: 4.2.2
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -27,6 +27,7 @@ Requires-Dist: pybind11>=2.11.0
 Requires-Dist: click>=8.0.0
 Requires-Dist: typing-extensions>=4.0.0
 Requires-Dist: requests>=2.28.0
+Requires-Dist: colorama>=0.4.0
 Dynamic: author-email
 Dynamic: home-page
 Dynamic: license-file
@@ -905,3 +906,103 @@ print(greeter.name)           # "Python"
 - `python::export(instance)` - Alias
 
 All three do the same thing: wrap a CSSL class instance for Python use.
+
+## Universal Instances (v4.0.3+)
+
+Universal instances are shared containers accessible from CSSL, Python, and C++:
+
+```python
+from includecpp import CSSL
+
+cssl = CSSL.CsslLang()
+
+# Create in CSSL
+cssl.run('''
+    instance<"myContainer"> container;
+    container.data = "Hello";
+    container.count = 42;
+''')
+
+# Access from Python
+container = cssl.getInstance("myContainer")
+print(container.data)   # "Hello"
+print(container.count)  # 42
+
+# Modify from Python
+container.newValue = "Added from Python"
+
+# Changes reflect in CSSL
+cssl.run('''
+    instance<"myContainer"> c;
+    printl(c.newValue);  // "Added from Python"
+''')
+```
+
+### Instance Methods
+
+```python
+cssl.getInstance("name")      # Get instance (None if not found)
+cssl.createInstance("name")   # Create or get instance
+cssl.deleteInstance("name")   # Delete instance
+cssl.listInstances()          # List all instance names
+```
+
+### Method Injection
+
+Inject methods into instances using `+<<==`:
+
+```cssl
+instance<"api"> api;
+
+// Inject a method
+api +<<== {
+    void greet(string name) {
+        printl("Hello, " + name + "!");
+    }
+};
+
+api.greet("World");  // Hello, World!
+```
+
+## Simplified Module API (v4.0.2+)
+
+Create CSSL modules from files with payload binding:
+
+```python
+from includecpp import CSSL
+
+# Register payload from file
+CSSL.makepayload("api", "lib/api/myapi.cssl-pl")
+
+# Create module from file, binding to payload
+mod = CSSL.makemodule("writer", "lib/writer.cssl", bind="api")
+mod.SaySomething("Hello!")  # Call functions directly
+```
+
+## VSCode Extension
+
+IncludeCPP includes a VSCode extension for CSSL syntax highlighting.
+
+### Installation
+
+```bash
+# Copy extension to VSCode extensions folder
+# Windows: %USERPROFILE%\.vscode\extensions\
+# Linux/Mac: ~/.vscode/extensions/
+
+# Or install from included files
+pip show includecpp  # Find package location
+# Copy vscode/cssl folder to extensions
+```
+
+### Features
+
+- Syntax highlighting for `.cssl`, `.cssl-pl`, `.cssl-mod` files
+- Snippets for common patterns
+- Run CSSL files with F5
+- Proper coloring for:
+  - Keywords and control flow
+  - Data types (purple/lilac)
+  - Variable declarations (light blue)
+  - Injection operators (`<<==`, `<==`)
+  - Global (`@`), shared (`$`), and captured (`%`) references

{includecpp-3.9.1 → includecpp-4.2.2}/IncludeCPP.egg-info/SOURCES.txt

@@ -4,6 +4,8 @@ README.md
 pyproject.toml
 requirements.txt
 setup.py
+./includecpp/CHANGELOG.md
+./includecpp/DOCUMENTATION.md
 ./includecpp/__init__.py
 ./includecpp/__init__.pyi
 ./includecpp/__main__.py
@@ -16,6 +18,7 @@ setup.py
 ./includecpp/core/build_manager.py
 ./includecpp/core/cpp_api.py
 ./includecpp/core/cpp_api.pyi
+./includecpp/core/cpp_api_extensions.pyi
 ./includecpp/core/cppy_converter.py
 ./includecpp/core/cssl_bridge.py
 ./includecpp/core/cssl_bridge.pyi
@@ -31,6 +34,7 @@ setup.py
 ./includecpp/core/cssl/cssl_builtins.py
 ./includecpp/core/cssl/cssl_builtins.pyi
 ./includecpp/core/cssl/cssl_events.py
+./includecpp/core/cssl/cssl_languages.py
 ./includecpp/core/cssl/cssl_modules.py
 ./includecpp/core/cssl/cssl_parser.py
 ./includecpp/core/cssl/cssl_runtime.py
@@ -57,6 +61,8 @@ IncludeCPP.egg-info/dependency_links.txt
 IncludeCPP.egg-info/entry_points.txt
 IncludeCPP.egg-info/requires.txt
 IncludeCPP.egg-info/top_level.txt
+includecpp/CHANGELOG.md
+includecpp/DOCUMENTATION.md
 includecpp/__init__.py
 includecpp/__init__.pyi
 includecpp/__main__.py
@@ -69,6 +75,7 @@ includecpp/core/ai_integration.py
 includecpp/core/build_manager.py
 includecpp/core/cpp_api.py
 includecpp/core/cpp_api.pyi
+includecpp/core/cpp_api_extensions.pyi
 includecpp/core/cppy_converter.py
 includecpp/core/cssl_bridge.py
 includecpp/core/cssl_bridge.pyi
@@ -84,6 +91,7 @@ includecpp/core/cssl/__init__.py
 includecpp/core/cssl/cssl_builtins.py
 includecpp/core/cssl/cssl_builtins.pyi
 includecpp/core/cssl/cssl_events.py
+includecpp/core/cssl/cssl_languages.py
 includecpp/core/cssl/cssl_modules.py
 includecpp/core/cssl/cssl_parser.py
 includecpp/core/cssl/cssl_runtime.py
@@ -103,4 +111,5 @@ includecpp/vscode/cssl/package.json
 includecpp/vscode/cssl/images/cssl.png
 includecpp/vscode/cssl/images/cssl_pl.png
 includecpp/vscode/cssl/snippets/cssl.snippets.json
-includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json
+includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json
+tests/test_multilang.py

{includecpp-3.9.1 → includecpp-4.2.2}/IncludeCPP.egg-info/requires.txt

@@ -2,3 +2,4 @@ pybind11>=2.11.0
 click>=8.0.0
 typing-extensions>=4.0.0
 requests>=2.28.0
+colorama>=0.4.0

{includecpp-3.9.1 → includecpp-4.2.2}/MANIFEST.in

@@ -5,4 +5,5 @@ recursive-include includecpp/templates *
 recursive-include includecpp/generator *.cpp *.h
 recursive-include includecpp *.py
 recursive-include includecpp *.pyi
+recursive-include includecpp *.md
 recursive-include includecpp/vscode *.json