IncludeCPP 4.2.2__tar.gz → 4.2.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.2.2
+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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 4.2.2
+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

{includecpp-4.2.2 → includecpp-4.2.5}/includecpp/CHANGELOG.md

@@ -1,6 +1,59 @@
 # IncludeCPP Changelog
 
-## v4.2.2 (2025-01-08)
+## 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
@@ -11,7 +64,7 @@
 
 ---
 
-## v4.2.1 (2025-01-08)
+## v4.2.1 (2026-01-08)
 
 ### CLI Improvements
 - `--doc` and `--doc "term"` now load from local DOCUMENTATION.md
@@ -25,7 +78,7 @@
 
 ---
 
-## v4.2.0 (2025-01-08)
+## v4.2.0 (2026-01-08)
 
 ### Multi-Language Support
 - Added `libinclude("language")` for loading language support modules

{includecpp-4.2.2 → includecpp-4.2.5}/includecpp/DOCUMENTATION.md

@@ -458,6 +458,57 @@ myFunc() +<<== {
 };
 ```
 
+### Function/Class Replacement (`&target`)
+
+Replace existing functions or classes with new implementations:
+
+```cssl
+// Define original function
+define original() {
+    return "original";
+}
+
+// Regular define: replacement happens when myFunc() is CALLED
+define myFunc() &original {
+    return "replaced";
+}
+
+original();   // Still returns "original"
+myFunc();     // Triggers replacement
+original();   // Now returns "replaced"
+
+// 'embedded' keyword: replacement happens IMMEDIATELY
+embedded immediateReplace() &original {
+    return "immediately replaced";
+}
+// original is already replaced after this line
+```
+
+### Embedded Classes
+
+```cssl
+class Game {
+    int score;
+}
+
+// Deferred: replacement when instantiated
+class BetterGame &Game {
+    int bonus;
+}
+
+// Immediate: replacement at registration
+embedded class SuperGame &$SharedGame {
+    int multiplier;
+}
+```
+
+| Syntax | Replacement Timing |
+|--------|-------------------|
+| `define func() &target { }` | Deferred (when called) |
+| `embedded func() &target { }` | Immediate (at registration) |
+| `class X &Target { }` | Deferred (when instantiated) |
+| `embedded class X &Target { }` | Immediate (at registration) |
+
 ---
 
 ## CSSL Modules

{includecpp-4.2.2 → includecpp-4.2.5}/includecpp/__init__.py

@@ -2,7 +2,7 @@ from .core.cpp_api import CppApi
 from .core import cssl_bridge as CSSL
 import warnings
 
-__version__ = "4.2.2"
+__version__ = "4.2.5"
 __all__ = ["CppApi", "CSSL"]
 
 # Module-level cache for C++ modules

{includecpp-4.2.2 → includecpp-4.2.5}/includecpp/cli/commands.py

@@ -7888,11 +7888,11 @@ def cssl_doc(search, list_sections):
                     click.echo()
                     click.echo("Or use: includecpp cssl doc --list")
         else:
-            # Full documentation mode
+            # Full documentation mode - output everything at once (no pager)
             # Replace Unicode characters that may not be supported on all terminals
             safe_content = content.replace('✓', '[OK]').replace('✗', '[X]').replace('→', '->').replace('←', '<-').replace('•', '*').replace('─', '-').replace('│', '|').replace('└', '+').replace('├', '+').replace('▸', '>').replace('▾', 'v')
             try:
-                click.echo_via_pager(safe_content)
+                click.echo(safe_content)
             except UnicodeEncodeError:
                 # Fallback: encode with errors='replace'
                 click.echo(safe_content.encode('ascii', errors='replace').decode('ascii'))