IncludeCPP 3.4.19__tar.gz → 3.4.22__tar.gz

{includecpp-3.4.19 → includecpp-3.4.22/IncludeCPP.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: IncludeCPP
-Version: 3.4.19
+Version: 3.4.22
 Summary: Professional C++ Python bindings with type-generic templates, pystubs and native threading
 Home-page: https://github.com/liliassg/IncludeCPP
 Author: Lilias Hatterscheidt
@@ -621,10 +621,277 @@ Then check **"Enable Experimental Features"** and save.
 - Have breaking changes between versions
 - Be removed or significantly changed
 
-Use at your own discretion. Report issues at: https://github.com/hatte/IncludeCPP/issues
+Use at your own discretion. Report issues at: https://github.com/liliassg/IncludeCPP/issues
+
+# CSSL - CSO Service Script Language
+
+IncludeCPP includes CSSL, a scripting language with advanced data manipulation features.
+
+## Basic Usage
+
+```python
+from includecpp import CSSL
+
+# Execute CSSL code
+CSSL.exec('''
+    printl("Hello from CSSL!");
+
+    int x = 10;
+    for (i in range(0, 5)) {
+        x = x + i;
+    }
+    printl(x);
+''')
+
+# Execute with arguments
+result = CSSL.exec('''
+    int a = parameter.get(0);
+    int b = parameter.get(1);
+    parameter.return(a + b);
+''', 5, 3)
+print(result)  # 8
+```
+
+## Live Object Sharing
+
+Share Python objects with CSSL scripts. Changes in CSSL reflect back to Python:
+
+```python
+from includecpp import CSSL
+
+class Counter:
+    def __init__(self):
+        self.value = 100
+
+counter = Counter()
+cssl = CSSL.CsslLang()
+cssl.share(counter, "cnt")
+
+# Modify in CSSL - changes reflect in Python!
+cssl.exec('''
+    $cnt.value = $cnt.value - 10;
+    printl($cnt.value);  // 90
+''')
+
+print(counter.value)  # 90 - Changed!
+```
+
+### Shared Object Syntax
+
+- `$name` - Access shared object
+- `$name.property` - Access/modify properties
+- `$name.method()` - Call methods
+- `delete("name")` - Remove shared object
+
+## Data Types
+
+```cssl
+// Basic types
+int x = 42;
+float pi = 3.14;
+string name = "CSSL";
+bool active = true;
+
+// Collections
+array<int> arr;
+arr.push(1);
+arr.push(2);
+printl(arr.length());  // 2
+
+vector<string> vec;
+vec.push("A");
+vec.push("B");
+
+stack<int> s;
+s.push(10);
+s.pop();
+```
+
+## Control Flow
+
+```cssl
+// If/elif/else
+if (x > 10) {
+    printl("big");
+} elif (x > 5) {
+    printl("medium");
+} else {
+    printl("small");
+}
+
+// For loops
+for (i in range(0, 10)) {
+    printl(i);
+}
+
+for (i in range(0, 10, 2)) {  // with step
+    printl(i);  // 0, 2, 4, 6, 8
+}
+
+// Foreach
+array<string> items;
+items.push("A");
+items.push("B");
+foreach (item in items) {
+    printl(item);
+}
+
+// While
+int count = 0;
+while (count < 5) {
+    printl(count);
+    count = count + 1;
+}
+```
+
+## Functions
+
+```cssl
+// Basic function
+void greet(string name) {
+    printl("Hello, " + name + "!");
+}
+
+// Return value
+int add(int a, int b) {
+    return a + b;
+}
+
+// Global variables
+global version = "1.0.0";
+printl(@version);
+
+// r@ syntax for global declaration
+r@myGlobal = "value";
+printl(@myGlobal);
+```
+
+## BruteForce Injection System
+
+CSSL's unique injection operators for data manipulation:
+
+```cssl
+// <== Move data (replaces target)
+target <== source;
+
+// +<== Copy & add to target
+target +<== source;
+
+// -<== Move & remove from source
+target -<== source;
+
+// <<== Code infusion into functions
+myFunc() <<== {
+    printl("Injected code!");
+};
+
+// +<<== Add code without replacing
+myFunc() +<<== {
+    printl("Additional code!");
+};
+```
+
+## String Methods
+
+```cssl
+string s = "Hello World";
+
+// Methods
+s.length();           // 11
+s.toUpper();          // "HELLO WORLD"
+s.toLower();          // "hello world"
+s.contains("World");  // true
+s.startsWith("Hello"); // true
+s.endsWith("World");  // true
+s.replace("World", "CSSL");
+s.split(" ");         // ["Hello", "World"]
+s.trim();             // Remove whitespace
+s.substring(0, 5);    // "Hello"
+```
+
+## CSSL Modules
+
+```python
+# Create callable module
+module = CSSL.module('''
+    string name = parameter.get(0);
+    printl("Hello, " + name + "!");
+''')
+module("World")  # Prints: Hello, World!
+
+# Create module with functions
+math_mod = CSSL.makemodule('''
+    int add(int a, int b) {
+        return a + b;
+    }
+
+    int multiply(int a, int b) {
+        return a * b;
+    }
+''')
+print(math_mod.add(2, 3))       # 5
+print(math_mod.multiply(4, 5))  # 20
+```
+
+## Inline Payloads
+
+```python
+cssl = CSSL.CsslLang()
+
+# Register code as payload
+cssl.code("helpers", '''
+    global version = "1.0.0";
+    void log(string msg) {
+        printl("[LOG] " + msg);
+    }
+''')
+
+# Use in CSSL
+cssl.exec('''
+    payload("helpers");
+    @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
@@ -806,4 +1073,4 @@ Use at your own discretion. Report issues at: https://github.com/hatte/IncludeCP
 
 ---
 
-MIT License | v3.4.2 | [GitHub](https://github.com/liliassg/IncludeCPP)
+MIT License | v3.4.20 | [GitHub](https://github.com/liliassg/IncludeCPP)

{includecpp-3.4.19 → includecpp-3.4.22}/IncludeCPP.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ setup.py
 ./includecpp/core/path_discovery.py
 ./includecpp/core/project_ui.py
 ./includecpp/core/settings_ui.py
+./includecpp/core/cssl/CSSL_DOCUMENTATION.md
 ./includecpp/core/cssl/__init__.py
 ./includecpp/core/cssl/cssl_builtins.py
 ./includecpp/core/cssl/cssl_events.py
@@ -39,6 +40,11 @@ setup.py
 ./includecpp/generator/type_resolver.cpp
 ./includecpp/generator/type_resolver.h
 ./includecpp/templates/cpp.proj.template
+./includecpp/vscode/__init__.py
+./includecpp/vscode/cssl/__init__.py
+./includecpp/vscode/cssl/language-configuration.json
+./includecpp/vscode/cssl/package.json
+./includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json
 IncludeCPP.egg-info/PKG-INFO
 IncludeCPP.egg-info/SOURCES.txt
 IncludeCPP.egg-info/dependency_links.txt
@@ -66,6 +72,7 @@ includecpp/core/exceptions.py
 includecpp/core/path_discovery.py
 includecpp/core/project_ui.py
 includecpp/core/settings_ui.py
+includecpp/core/cssl/CSSL_DOCUMENTATION.md
 includecpp/core/cssl/__init__.py
 includecpp/core/cssl/cssl_builtins.py
 includecpp/core/cssl/cssl_events.py
@@ -79,4 +86,9 @@ includecpp/generator/parser.cpp
 includecpp/generator/parser.h
 includecpp/generator/type_resolver.cpp
 includecpp/generator/type_resolver.h
-includecpp/templates/cpp.proj.template
+includecpp/templates/cpp.proj.template
+includecpp/vscode/__init__.py
+includecpp/vscode/cssl/__init__.py
+includecpp/vscode/cssl/language-configuration.json
+includecpp/vscode/cssl/package.json
+includecpp/vscode/cssl/syntaxes/cssl.tmLanguage.json