IncludeCPP 4.0.3__tar.gz → 4.2.5__tar.gz

{includecpp-4.0.3 → includecpp-4.2.5}/IncludeCPP.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.0.3
+Version: 4.2.5
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -906,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-4.0.3 → includecpp-4.2.5}/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-4.0.3 → includecpp-4.2.5}/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

{includecpp-4.0.3 → includecpp-4.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.0.3
+Version: 4.2.5
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -906,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-4.0.3 → includecpp-4.2.5}/README.md

@@ -870,4 +870,104 @@ print(greeter.name)           # "Python"
 - `python::wrap(instance)` - Alias
 - `python::export(instance)` - Alias
 
-All three do the same thing: wrap a CSSL class instance for Python use.
+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-4.2.5/includecpp/CHANGELOG.md

@@ -0,0 +1,228 @@
+# IncludeCPP Changelog
+
+## v4.2.5 (2026-01-08)
+
+### New Features
+- **Added `embedded` keyword for immediate `&target` replacement**
+  - `embedded func() &exit { }` - replaces `exit` immediately at registration
+  - `embedded class MyClass &$Target { }` - replaces `$Target` immediately at registration
+  - Regular `define func() &target { }` now defers replacement until function is called
+  - Regular `class MyClass &$Target { }` now defers replacement until class is instantiated
+  - `: overwrites` behavior remains unchanged (always immediate)
+- Added VSCode syntax highlighting for `embedded` keyword
+- **Added `switch` for open parameters** - pattern matching on provided named parameters
+  - `case name:` - executes if parameter exists
+  - `case name & age:` - executes if both parameters exist (AND)
+  - `case name & not age:` - executes if name exists AND age doesn't
+  - `except name:` - executes if parameter does NOT exist
+  - `default:` - executes if no case matched
+  - `always:` - executes after any matching case
+  - `finally:` - executes regardless of match (cleanup)
+
+### Bug Fixes
+- **Fixed `OpenFind<type, "name">` returning function reference instead of value**
+  - `OpenFind<dynamic, "task">` now works without `()` parentheses
+  - Both `OpenFind<type, "name">` and `OpenFind<type>(index)` work correctly
+
+### Behavior Changes
+- **`&target` replacement timing**:
+  - `define func() &exit { }` - deferred (only when `func()` is called)
+  - `embedded func() &exit { }` - immediate (at registration)
+  - `class MyClass &$Game { }` - deferred (only when `new MyClass()` is called)
+  - `embedded class MyClass &$Game { }` - immediate (at registration)
+
+---
+
+## v4.2.4 (2026-01-08)
+
+### Bug Fixes
+- **Fixed `%name` priority for `&function` overrides** - `%exit()` now correctly calls the original builtin
+  - `define _exit() &exit { %exit(); }` no longer causes infinite recursion
+  - Original functions are stored BEFORE replacement for proper `%` capture
+  - `_original_functions` is checked FIRST when resolving `%name` references
+
+---
+
+## v4.2.3 (2026-01-08)
+
+### Bug Fixes
+- Removed pagination from `includecpp cssl doc` - documentation now outputs completely without requiring Enter
+- **Fixed `&builtin` function override** - `define MyFunc() &exit { ... }` now properly replaces builtin functions
+  - `&exit`, `&printl`, `&input`, etc. now correctly override the builtin implementations
+  - Builtins in scope were incorrectly treated as CSSLClass instances, preventing override
+
+---
+
+## v4.2.2 (2026-01-08)
+
+### Bug Fixes
+- **Fixed bidirectional `lang$Instance` mutations** - Cross-language instance access now correctly modifies shared objects
+  - `js$GameData.score = 1337` now properly updates the original instance
+  - All mutations via `lang$Instance.member = value` are now applied bidirectionally
+- Fixed `LANG_INSTANCE_REF` token not being recognized in `parse_program()`, `_parse_statement()`, and `_parse_action_block()`
+- Parser now correctly handles `lang$Instance` as a valid expression start token
+
+---
+
+## v4.2.1 (2026-01-08)
+
+### CLI Improvements
+- `--doc` and `--doc "term"` now load from local DOCUMENTATION.md
+- `--changelog` now loads from local CHANGELOG.md
+- Added `--changelog --N` (e.g., `--changelog --5`) for showing N releases
+- Added `--changelog --all` for showing all releases
+
+### Documentation
+- Added comprehensive DOCUMENTATION.md for CLI reference
+- Added CHANGELOG.md for version history
+
+---
+
+## v4.2.0 (2026-01-08)
+
+### Multi-Language Support
+- Added `libinclude("language")` for loading language support modules
+- Added `supports <lang>` keyword for writing in other language syntax
+- Added cross-language instance sharing with `lang$InstanceName` syntax
+- Added language transformers for Python, JavaScript, Java, C#, C++
+- Added default parameter values in CSSL functions
+
+### SDK Packages
+- Added C++ SDK (`sdk/cpp/includecpp.h`)
+- Added Java SDK (`sdk/java/src/com/includecpp/CSSL.java`)
+- Added C# SDK (`sdk/csharp/IncludeCPP.cs`)
+- Added JavaScript SDK (`sdk/javascript/includecpp.js`)
+- Added `includecpp cssl sdk <lang>` command to generate SDKs
+
+### CLI Improvements
+- Added `--doc "searchterm"` for documentation search
+- Added `--changelog --all`, `--changelog --N` for changelog viewing
+- Improved error messages with line context
+
+### Bug Fixes
+- Fixed compound assignment operators in Python transformer (-=, +=, *=, /=)
+- Fixed type annotation stripping in `supports python` blocks
+- Fixed self parameter handling in Python method transformation
+
+---
+
+## v4.1.0 (2024-12-15)
+
+### CodeInfusion System
+- Added `<<==` operator for code injection into functions
+- Added `+<<==` for appending code without replacing
+- Added method appending with `&Class::method` syntax
+- Added `++` append mode for function definitions
+
+### Class Improvements
+- Added `overwrites` keyword for method replacement
+- Added `extends Parent::method` for method-level inheritance
+- Added `super()` and `super::method()` calls
+- Added shuffled returns with `shuffled<T>` type
+
+### New Containers
+- Added `combo<T>` for filter/search operations
+- Added `iterator<T>` for programmable iterators
+- Added `datastruct<T>` universal container
+
+### Python Interop
+- Added `python::pythonize()` for returning CSSL classes to Python
+- Added `python::wrap()` and `python::export()` aliases
+- Added universal instances with `instance<"name">`
+
+---
+
+## v4.0.3 (2024-11-20)
+
+### Universal Instances
+- Added `instance<"name">` for cross-runtime shared containers
+- Added `cssl.getInstance("name")` Python API
+- Added `cssl.createInstance("name")` Python API
+- Added `cssl.deleteInstance("name")` Python API
+- Added method injection into instances with `+<<==`
+
+### Module System
+- Added `CSSL.makemodule()` for creating callable modules
+- Added `CSSL.makepayload()` for payload file registration
+- Added payload binding with `bind=` parameter
+
+---
+
+## v4.0.2 (2024-11-01)
+
+### Simplified API
+- Added `CSSL.run()` as main entry point
+- Added `CSSL.module()` for creating modules from strings
+- Added `CSSL.script()` for inline payload registration
+- Improved parameter handling with `parameter.get()` and `parameter.return()`
+
+### Shared Objects
+- Added `cssl.share(obj, "name")` for Python object sharing
+- Added `$name` syntax for accessing shared objects
+- Changes in CSSL reflect back to Python objects
+
+---
+
+## v4.0.0 (2024-10-15)
+
+### Major Release
+- Complete rewrite of CSSL parser and runtime
+- Added generic container types (`stack<T>`, `vector<T>`, `map<K,V>`)
+- Added class system with constructors and inheritance
+- Added BruteInjection operators (`<==`, `+<==`, `-<==`)
+- Added global variables with `@name` syntax
+- Added captured variables with `%name` syntax
+
+### AI Integration
+- Added `includecpp ai` command group
+- Added AI-assisted code analysis
+- Added AI-powered optimization
+- Added `includecpp ai ask` for project questions
+
+---
+
+## v3.2.0 (2024-09-01)
+
+### CPPY Conversion
+- Added `includecpp cppy convert` command
+- Added Python to C++ conversion
+- Added C++ to Python conversion
+- Added AI-assisted conversion with `--ai` flag
+- Added type mapping tables
+
+### Build Improvements
+- Added `--fast` flag for incremental builds
+- Added object file caching
+- Added SHA256 hash checking for unchanged modules
+- Reduced rebuild time to ~0.4s when unchanged
+
+---
+
+## v3.1.0 (2024-08-01)
+
+### CLI Enhancements
+- Added `includecpp auto` command
+- Added `includecpp fix` for code analysis
+- Added `--verbose` flag for detailed output
+- Added `-j` flag for parallel jobs
+
+### Plugin Format
+- Added `DEPENDS()` for module dependencies
+- Added `TEMPLATE_FUNC()` for template instantiation
+- Added `METHOD_CONST()` for overloaded methods
+
+---
+
+## v3.0.0 (2024-07-01)
+
+### Initial CSSL
+- Added CSSL scripting language
+- Added basic data types and control flow
+- Added functions and basic classes
+- Added Python interop with shared objects
+
+### Core Features
+- C++ to Python binding generation
+- Plugin file format (.cp)
+- CMake-based build system
+- Cross-platform support (Windows, Linux, Mac)