IncludeCPP 3.7.25__py3-none-any.whl → 3.8.8__py3-none-any.whl

{includecpp-3.7.25.dist-info → includecpp-3.8.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.7.25
+Version: 3.8.8
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -839,7 +839,7 @@ print(math_mod.multiply(4, 5))  # 20
 cssl = CSSL.CsslLang()
 
 # Register code as payload
-cssl.code("helpers", '''
+cssl.script(<name>, "helpers", '''
     global version = "1.0.0";
     void log(string msg) {
         printl("[LOG] " + msg);
@@ -847,230 +847,61 @@ cssl.code("helpers", '''
 ''')
 
 # Use in CSSL
-cssl.exec('''
-    payload("helpers");
+cssl.run('''
+    payload("<name>"); // use module you declared in cssl.script(<name>, ...)
     @log("Application started");
     printl(@version);
 ''')
 ```
 
-# Changelog
-
-## v3.4.20
-- **Documentation:**
-  - Added complete CSSL language documentation
-  - Live object sharing with `$name` syntax
-  - Data types, control flow, functions, injection system
-  - String methods, modules, and inline payloads
-
-## v3.4.19
-- **Critical Bug Fixes:**
-  - Fixed generator raw string literal in parser.cpp (regex pattern with `)"` prematurely terminated)
-  - Fixed shared object property writes inside loops not persisting to Python
-  - Added member_access handling in flow operations for shared objects
-
-## v3.4.18
-- **Bug Fix:**
-  - Attempted fix for shared object loop writes (partially fixed)
-
-## v3.4.17
-- **New Feature: Live Object Sharing**
-  - `cssl.share(instance, name)` - Share Python objects with CSSL
-  - `$name` syntax for accessing shared objects
-  - Live bidirectional updates - changes in CSSL reflect in Python
-  - `delete("name")` builtin for removing shared objects
-  - Shared object metadata stored in `%APPDATA%/IncludeCPP/shared_objects/`
-
-## v3.4.16
-- **CSSL Bug Fixes:**
-  - Fixed `startsWith()` and `endsWith()` parser errors
-
-## v3.4.15
-- **CSSL Enhancements:**
-  - Added `elif` keyword support
-  - Added `range(start, end, step)` with step parameter
-  - Added `begin()` and `end()` methods to all collection types
-  - Added `cssl.code(name, code)` for inline payload registration
-
-## v3.4.2
-- **New Feature: `exec` Command**
-  - Interactive REPL for quick code testing without creating files
-  - `includecpp exec py` - Python REPL with IncludeCPP support
-  - `includecpp exec cpp` - C++ REPL with auto-compilation
-  - Auto-import modules: `includecpp exec py mymodule`
-  - Auto-import from plugins: `includecpp exec py plugins/math.cp`
-  - Import all modules: `includecpp exec py --all`
-  - Enter code line by line, press ENTER on empty line to execute
-
-## v3.4.1
-- **Bug Fixes:**
-  - fix command: Fixed false positives for unused variables (sum, memory_) using word-boundary matching
-  - CPPY: C++ reserved words (double, int, void, etc.) now properly escaped as Python identifiers
-  - CPPY: C++ STL functions (accumulate, find, sort, reverse) properly converted to Python equivalents
-  - CPPY: Member variables with trailing underscore (memory_) now get self. prefix
-  - CPPY: Private class members now detected for self. prefix conversion
-  - Plugin: Auto-detect header files from #include directives in source files
-
-## v3.4.0
-- **CodeMaker Major Update:**
-  - New Source node type with 8 connection ports for code generation
-  - Smart code generation: Source nodes generate Python/Plugin files with all connected nodes included
-  - Right-click on Source node: "Create Python" creates .py in project root
-  - Right-click on Source node: "Create Plugin" creates .cp, .h, .cpp in plugins/ and include/
-  - Code options hidden after file generation (prevents duplicates)
-  - Enhanced description display with background rect in node body
-  - Arrow key navigation to pan the canvas
-  - New toolbar buttons: Align H, Align V, Auto-Arrange
-  - Quick-add buttons: +Source, +Class, +Function
-  - Properties Panel on the right side for editing selected nodes
-  - Auto-arrange algorithm for grid layout
-  - Align horizontal/vertical for selected nodes
-- **Bug Fixes:**
-  - Changelog encoding fixes for Windows console
-  - CPPY C++ keyword escaping (double, int, etc.)
-  - CPPY C++ to Python syntax conversion improvements
-  - CPPY self. prefix for member variables
-  - Plugin auto-header detection from #include
-
-## v3.3.21
-- **Encoding Fixes:**
-  - Replaced Unicode arrow characters with ASCII in changelog (Windows console compatibility)
-
-## v3.3.20
-- **Bug Fixes:**
-  - Fixed `QPoint.toPoint()` AttributeError in rubber band selection
-  - Added UTF-8 encoding to all file read/write operations for cross-platform compatibility
-  - Fixed bare `except:` clauses to proper `except Exception:` in settings_ui.py
-
-## v3.3.19
-- **PyQt6 Import Fix:**
-  - Fixed silent import failure that caused "PyQt6 not installed" error even when installed
-  - Moved `QUndoStack`, `QUndoCommand`, `QShortcut` from QtWidgets to QtGui (correct location in PyQt6)
-
-## v3.3.18
-- **CodeMaker Visual Editor (Experimental):**
-  - Complete rewrite of `project` command with professional-grade UI
-  - 24 node types across 5 categories (Code Structures, Functions, Data, Organization, Flow)
-  - Undo/redo system with full command history
-  - Multi-selection with rubber band and Ctrl+Click
-  - Copy/paste/duplicate with Ctrl+C/V/D shortcuts
-  - Node grouping with Ctrl+G
-  - Code generation for C++ (header/source) and Python
-  - Search and filter nodes by name and type
-  - Export to PNG/SVG with transparency support
-  - Categorized right-click context menus
-  - Toolbar with common actions
-  - Cross-platform font detection (Windows/macOS/Linux)
-  - DPI-aware scaling for high-resolution displays
-- **Experimental Feature Gating:**
-  - `project` command now requires "Enable Experimental Features" in settings
-  - Consistent gating with `ai` and `cppy` commands
-
-## v3.3.16-3.3.17
-- **QPen Bug Fixes:**
-  - Fixed 3 instances of `setPen(Qt.PenStyle.NoPen)` to `setPen(QPen(Qt.PenStyle.NoPen))`
-  - Proper QPen construction for PyQt6 compatibility
-
-## v3.3.15
-- **CPPY Converter Major Fixes:**
-  - Functions returning container now get `std::vector<T>` return type (e.g., shuffle_list)
-  - `max(items)` / `min(items)` now correctly uses `std::max_element` / `std::min_element`
-  - Template element parameters (`value`, `item`) now use `const T&` instead of `double`
-  - Explicit template instantiations now include correct return types and all parameters
-  - Python docstrings now become C++ comments instead of dangling string literals
-- **Unicode Fallback System:**
-  - AI progress indicators use ASCII fallbacks on Windows terminals
-  - Fixed encoding errors in changelog display
-
-## v3.3.14
-- **Experimental Features System:**
-  - AI and CPPY commands now hidden by default
-  - Enable via Settings UI: "Enable Experimental Features" checkbox
-  - Warning about potential bugs documented in README
-- **Settings UI Improvements:**
-  - Added scrollable content area to prevent layout squashing
-  - New "Experimental" section with orange header
-  - Better spacing and styling for all elements
-  - Preserved existing config values on save
-
-## v3.3.13
-- **Template Support for Generic Functions:**
-  - Generic container parameters now generate proper C++ templates
-  - `template<typename T> T getChoice(const std::vector<T>& choices)` instead of invalid `std::vector<auto>`
-  - Automatic explicit template instantiations for int, double, std::string
-- **AI Conversion - No pybind11:**
-  - AI no longer generates pybind11 code - IncludeCPP handles bindings automatically
-  - Clean C++ output in `namespace includecpp`
-  - User runs `includecpp plugin` separately to generate bindings
-- **AI Context - Dynamic README:**
-  - AI now loads README.md dynamically for accurate IncludeCPP documentation
-  - Better understanding of IncludeCPP workflow and patterns
-
-## v3.3.12
-- **Smart Type Inference:**
-  - Parameter types now inferred from common naming patterns (start/end -> int, name/path -> string, etc.)
-  - Variable type tracking throughout conversion for accurate string detection
-  - Loop variable types inferred from iterables (enumerate, for loops)
-- **String Conversion Fix:**
-  - No more `std::to_string()` on already-string variables in f-strings
-  - `_is_string_expr()` method for comprehensive string type detection
-  - String variables detected by name, type tracking, and method calls
-- **AI Conversion Improvements:**
-  - Explicit file extension enforcement (.cpp NOT .cp, .h NOT .hpp)
-  - Better --no-h flag handling with clear AI instructions
-  - AI can request clarification on unconvertible modules (tkinter, pygame, etc.)
-  - User prompted for input when AI needs guidance
-
-## v3.3.11
-- **CPPY Converter Improvements:**
-  - Added `_safe_arg()` and `_safe_get()` for robust bounds checking on all args
-  - Added comprehensive try-except handling in `_convert_expr()` with warnings
-  - Improved type inference with empty container handling and exception safety
-  - Complete string escaping: `\0`, `\f`, `\b`, `\a`, `\v` now properly escaped
-- **New Python Constructs:**
-  - Dict comprehensions: `{k: v for k, v in items}` now converts to C++
-  - Set comprehensions: `{x for x in items}` now converts to C++
-  - Generator expressions: `(x for x in items)` now converts to vector
-  - Tuple unpacking: `a, b = func()` now uses C++17 structured bindings
-- **AI Conversion Flags:**
-  - New `--think` flag for less context mode
-  - New `--think3` flag for maximum context mode
-  - New `--websearch` flag for web search in AI conversion
-  - Default: `--think2` mode (unchanged behavior)
-
-## v3.3.10
-- **CPPY Converter seeded RNG fixes:**
-  - Fixed `rng = random.Random(seed)` then `rng.randint()` - now properly tracks seeded RNG variables
-  - Fixed `random.choices(...)[0]` subscript - returns single element directly without `[0]`
-  - Seeded RNG methods (randint, uniform, choice, random) now use the tracked variable with proper C++ distributions
-
-## v3.3.9
-- **CPPY Converter fixes:**
-  - Added f-string (JoinedStr) support - f"text {expr}" now converts to string concatenation
-  - Fixed `random.Random(seed).method()` chained calls - now generates proper inline lambda with seeded RNG
-  - Fixed `random.choices(items, weights=weights)` keyword argument handling
-  - Improved string type detection in f-string expressions
-
-## v3.3.8
-- **Major rulebased converter improvements:**
-  - Added Python `random` module support (randint, uniform, choice, sample, shuffle, gauss, etc.)
-  - Added `os` module support (getcwd, path.join, path.exists, listdir, mkdir, etc.)
-  - Added `time` module support (sleep, time, perf_counter, monotonic)
-  - Added `sys` module support (exit, platform)
-  - Added `math` module support (sqrt, pow, sin, cos, log, etc.)
-  - Added `re` (regex) module support (match, search, sub, findall)
-  - Added `threading` module support (Thread, Lock, Semaphore, etc.)
-  - Added `collections` module support (deque, defaultdict, Counter)
-  - Added `pathlib.Path` support
-- **Unconvertible code detection:**
-  - Automatically detects GUI frameworks (tkinter, PyQt, PySide, pygame) and other unconvertible modules
-  - Shows red warning with line numbers when unconvertible code is found
-  - New `--force` flag to convert anyway (with `/* UNCONVERTIBLE */` comments)
-  - Supports 30+ modules in detection (numpy, pandas, flask, django, etc.)
-- Fixed duplicate file output in `cppy convert --ai`
-- Plugin command now skips inline and underscore-prefixed functions
-
-
----
-
-MIT License | v3.4.20 | [GitHub](https://github.com/liliassg/IncludeCPP)
+## Return CSSL Classes to Python
+
+Use `python::pythonize()` to convert CSSL class instances into Python-usable objects:
+
+```python
+from includecpp import CSSL
+
+cssl = CSSL.CsslLang()
+
+# Create and return a CSSL class as a Python object
+greeter = cssl.run('''
+    class Greeter {
+        string name;
+
+        Greeter(string n) {
+            this->name = n;
+        }
+
+        string sayHello() {
+            return "Hello, " + this->name + "!";
+        }
+
+        void setName(string newName) {
+            this->name = newName;
+        }
+
+        string getName() {
+            return this->name;
+        }
+    }
+
+    instance = new Greeter("World");
+    pyclass = python::pythonize(instance);
+    parameter.return(pyclass);
+''')
+
+# Now use it like a normal Python object!
+print(greeter.name)           # "World"
+print(greeter.sayHello())     # "Hello, World!"
+greeter.setName("Python")
+print(greeter.getName())      # "Python"
+print(greeter.name)           # "Python"
+```
+
+### Aliases
+
+- `python::pythonize(instance)` - Main function
+- `python::wrap(instance)` - Alias
+- `python::export(instance)` - Alias
+
+All three do the same thing: wrap a CSSL class instance for Python use.

{includecpp-3.7.25.dist-info → includecpp-3.8.8.dist-info}/RECORD

@@ -1,9 +1,9 @@
-includecpp/__init__.py,sha256=YgP_G9kl_90bbm_zr9NJq-rDfpM76tC8vfJGNIHBYxY,1673
+includecpp/__init__.py,sha256=XmL_pnk_lOdqLw9gz6GfffxGKt1ea79WjLE-G_myEwI,1672
 includecpp/__init__.pyi,sha256=uSDYlbqd2TinmrdepmE_zvN25jd3Co2cgyPzXgDpopM,7193
 includecpp/__main__.py,sha256=d6QK0PkvUe1ENofpmHRAg3bwNbZr8PiRscfI3-WRfVg,72
 includecpp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 includecpp/cli/__init__.py,sha256=Yda-4a5QJb_tKu35YQNfc5lu-LewTsM5abqNNkzS47M,113
-includecpp/cli/commands.py,sha256=HDoRuPEPTzxZQcR4rF45GrRVtcw3zDj6cGiwLCZB44Y,349597
+includecpp/cli/commands.py,sha256=R1wZeka7AMUVd61TSTUZ2utjCdorFY3wO_Ahs749iyc,350475
 includecpp/cli/config_parser.py,sha256=KveeYUg2TA9sC5hKVzYYfgdNm2WfLG5y7_yxgBWn9yM,4886
 includecpp/core/__init__.py,sha256=L1bT6oikTjdto-6Px7DpjePtM07ymo3Bnov1saZzsGg,390
 includecpp/core/ai_integration.py,sha256=PW6yFDqdXjfchpfKTKg59AOLhLry9kqJEGf_65BztrY,87603
@@ -19,16 +19,16 @@ includecpp/core/exceptions.py,sha256=szeF4qdzi_q8hBBZi7mJxkliyQ0crplkLYe0ymlBGtk
 includecpp/core/path_discovery.py,sha256=jI0oSq6Hsd4LKXmU4dOiGSrXcEO_KWMXfQ5_ylBmXvU,2561
 includecpp/core/project_ui.py,sha256=la2EQZKmUkJGuJxnbs09hH1ZhBh9bfndo6okzZsk2dQ,141134
 includecpp/core/settings_ui.py,sha256=B2SlwgdplF2KiBk5UYf2l8Jjifjd0F-FmBP0DPsVCEQ,11798
-includecpp/core/cssl/CSSL_DOCUMENTATION.md,sha256=47sUPO-FMq_8_CrJBZFoFBgSO3gSi5zoB1Xp7oeifho,40773
+includecpp/core/cssl/CSSL_DOCUMENTATION.md,sha256=UF2RpPyuUWrU08E49t19OcsGModkwlRvajDWifCxqFo,48051
 includecpp/core/cssl/__init__.py,sha256=scDXRBNK2L6A8qmlpNyaqQj6BFcSfPInBlucdeNfMF0,1975
-includecpp/core/cssl/cssl_builtins.py,sha256=r-FX4WQeKxerkepqodIiwhtL_kxxa4PJym_WyWIwA_s,92290
+includecpp/core/cssl/cssl_builtins.py,sha256=oPsPyQk5b0b1I02Y80oIaDX39GOeG32-nBPEqwbo_Pw,105110
 includecpp/core/cssl/cssl_builtins.pyi,sha256=3ai2V4LyhzPBhAKjRRf0rLVu_bg9ECmTfTkdFKM64iA,127430
 includecpp/core/cssl/cssl_events.py,sha256=nupIcXW_Vjdud7zCU6hdwkQRQ0MujlPM7Tk2u7eDAiY,21013
 includecpp/core/cssl/cssl_modules.py,sha256=cUg0-zdymMnWWTsA_BUrW5dx4R04dHpKcUhm-Wfiwwo,103006
-includecpp/core/cssl/cssl_parser.py,sha256=fphjjN2MRURMkqi0lFEf6l61xC9IPImlYVjlqonZZHc,117139
-includecpp/core/cssl/cssl_runtime.py,sha256=iZgNcKDoTeV50-IsXcsrpuTyDPxEHWyQz5uR3s5UVHg,154613
+includecpp/core/cssl/cssl_parser.py,sha256=4e2qXFmnc6bw4dEQsuOJpJHEVjZLxWLA0BOvgk8F9-Y,136619
+includecpp/core/cssl/cssl_runtime.py,sha256=e_4XnjS2CkDhEdXb9P9lt3wxrQrcfZeGCIp4d1smTLA,177848
 includecpp/core/cssl/cssl_syntax.py,sha256=bgo3NFehoPTQa5dqwNd_CstkVGVCNYAXbGYUcu5BEN0,16982
-includecpp/core/cssl/cssl_types.py,sha256=gVjtfxk0Uzfj-H7_LD79oqspFMYDf79ZrRrlZk8eAEs,50647
+includecpp/core/cssl/cssl_types.py,sha256=7jbrtZf3xmVQJA_mnL9iYrmdjhjuc4--mxxNigi7fsk,53425
 includecpp/generator/__init__.py,sha256=Rsy41bwimaEloD3gDRR_znPfIJzIsCFuWZgCTJBLJlc,62
 includecpp/generator/parser.cpp,sha256=hbhHdtFH65rzp6prnARN9pNFF_ssr0NseVVcxq0fJh4,76833
 includecpp/generator/parser.h,sha256=EDm0b-pEesIIIQQ2PvH5h2qwlqJU9BH8SiMV7MWbsTo,11073
@@ -37,16 +37,16 @@ includecpp/generator/type_resolver.h,sha256=ZsaxQqcCcKJJApYn7KOp2dLlQ1VFVG_oZDja
 includecpp/templates/cpp.proj.template,sha256=Iy-L8I4Cl3tIgBMx1Qp5h6gURvkqOAqyodVHuDJ0Luw,359
 includecpp/vscode/__init__.py,sha256=yLKw-_7MTX1Rx3jLk5JjharJQfFXbwtZVE7YqHpM7yg,39
 includecpp/vscode/cssl/__init__.py,sha256=rQJAx5X05v-mAwqX1Qb-rbZO219iR73MziFNRUCNUIo,31
-includecpp/vscode/cssl/extension.js,sha256=YLFDuKQVdGi15l_vUadD9nlu8mcjzUm_rKj4-oxV-ak,4302
+includecpp/vscode/cssl/extension.js,sha256=FZaKfOpzo2jXtubVCZmnhDZd4eUVHltm5VW_fgNnSkE,4327
 includecpp/vscode/cssl/language-configuration.json,sha256=61Q00cKI9may5L8YpxMmvfo6PAc-abdJqApfR85DWuw,904
-includecpp/vscode/cssl/package.json,sha256=Zu2QoTE0OVCCDUHp1hc7kN2NBbFs60bX-LLGMpXz25M,4853
+includecpp/vscode/cssl/package.json,sha256=5MCJts7zYIgF8EdWcBnn98deIMyZamlGXvt1acO0Q1U,4853
 includecpp/vscode/cssl/images/cssl.png,sha256=BxAGsnfS0ZzzCvqV6Zb1OAJAZpDUoXlR86MsvUGlSZw,510
 includecpp/vscode/cssl/images/cssl_pl.png,sha256=z4WMk7g6YCTbUUbSFk343BO6yi_OmNEVYkRenWGydwM,799
-includecpp/vscode/cssl/snippets/cssl.snippets.json,sha256=l4SCEPR3CsPxA8HIVLKYY__I979TfKzYWtH1KYIsboo,33062
-includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json,sha256=XKRLBOHlCqDDnGPvmNHDQPsIMR1UD9PBaJIlgZOiPqM,21173
-includecpp-3.7.25.dist-info/licenses/LICENSE,sha256=fWCsGGsiWZir0UzDd20Hh-3wtRyk1zqUntvtVuAWhvc,1093
-includecpp-3.7.25.dist-info/METADATA,sha256=7e3lYqfMjuU6hs9mv5Ol5l7Zpjtr5I_QXp5Mmxh2ftQ,32122
-includecpp-3.7.25.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-includecpp-3.7.25.dist-info/entry_points.txt,sha256=6A5Mif9gi0139Bf03W5plAb3wnAgbNaEVe1HJoGE-2o,59
-includecpp-3.7.25.dist-info/top_level.txt,sha256=RFUaR1KG-M6mCYwP6w4ydP5Cgc8yNbP78jxGAvyjMa8,11
-includecpp-3.7.25.dist-info/RECORD,,
+includecpp/vscode/cssl/snippets/cssl.snippets.json,sha256=uV3nHJyQ5f7Pr3FzfbQT2VZOEY3AlGs4wrmqe884jm4,37372
+includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json,sha256=l62jwXdjMx7-awg5X9WNBrGs4m34uP8W1CV7U7cpP4Y,34004
+includecpp-3.8.8.dist-info/licenses/LICENSE,sha256=fWCsGGsiWZir0UzDd20Hh-3wtRyk1zqUntvtVuAWhvc,1093
+includecpp-3.8.8.dist-info/METADATA,sha256=lytD7GrK-26_ShDT7te-HvWJf8EupZ7i9hnlCM7OUUs,22510
+includecpp-3.8.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+includecpp-3.8.8.dist-info/entry_points.txt,sha256=6A5Mif9gi0139Bf03W5plAb3wnAgbNaEVe1HJoGE-2o,59
+includecpp-3.8.8.dist-info/top_level.txt,sha256=RFUaR1KG-M6mCYwP6w4ydP5Cgc8yNbP78jxGAvyjMa8,11
+includecpp-3.8.8.dist-info/RECORD,,