IncludeCPP 3.9.1__tar.gz → 4.0.3__tar.gz

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

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

{includecpp-3.9.1 → includecpp-4.0.3}/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.0.3}/PKG-INFO

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

{includecpp-3.9.1 → includecpp-4.0.3}/includecpp/__init__.py

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

{includecpp-3.9.1 → includecpp-4.0.3}/includecpp/cli/commands.py

@@ -9,8 +9,12 @@ import re
 import urllib.request
 import urllib.error
 from pathlib import Path
+from colorama import init as colorama_init, Fore, Style
 from .config_parser import CppProjectConfig
 
+# Initialize colorama for Windows ANSI color support
+colorama_init()
+
 
 def _is_experimental_enabled() -> bool:
     """Check if experimental features (cppy, ai) are enabled."""
@@ -7320,7 +7324,6 @@ def exec_repl(lang, path, import_all):
     code_lines = imports + [''] + lines if imports else lines
 
     click.echo()
-    click.secho("--- Output ---", fg='green')
 
     if is_python:
         # Execute Python code
@@ -7443,9 +7446,6 @@ def exec_repl(lang, path, import_all):
             except Exception:
                 pass
 
-    click.echo()
-    click.secho("--------------", fg='green')
-
 
 # ============================================================================
 # CSSL - Hidden Command Group
@@ -7526,19 +7526,12 @@ def _cssl_execute(path, code):
         source = '\n'.join(lines)
 
     # Execute
-    click.secho("--- Output ---", fg='green')
     try:
         result = cssl_lang.run(source)
-
-        # Output is already printed to stdout during execution via runtime.output()
-        # Don't print "Result:" automatically - users should use printl() for output
-        # This prevents unwanted output for function calls like: Function();
-        pass
-
     except Exception as e:
-        click.secho(f"CSSL Error: {e}", fg='red')
-
-    click.secho("--------------", fg='green')
+        error_msg = str(e)
+        # Clean display - single CSSL Error: prefix with colorama
+        click.echo(f"{Fore.RED}CSSL Error: {error_msg}{Style.RESET_ALL}")
 
 
 @cssl.command(name='makemodule')

{includecpp-3.9.1 → includecpp-4.0.3}/includecpp/core/cssl/CSSL_DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # CSSL - C-Style Scripting Language
 
-> Version 3.9.1 | A modern scripting language with C++-style syntax and unique features like CodeInfusion, BruteInjection, and Python Interop.
+> Version 4.0.0 | A modern scripting language with C++-style syntax and unique features like CodeInfusion, BruteInjection, and Python Interop.
 
 ---
 
@@ -168,6 +168,42 @@ isnull(null);         // true
 
 ## Variables & Globals
 
+### Scope Behavior
+
+Variables are **local by default**. Each function/class has its own scope - variables defined inside a function only exist within that function.
+
+```cssl
+define myFunction() {
+    string name = "Alice";  // Local to myFunction
+    printl(name);           // Works
+}
+
+myFunction();
+// printl(name);  // Error! 'name' doesn't exist here
+
+// Same variable name in different scopes = different variables
+string name = "Bob";
+
+define otherFunction() {
+    string name = "Charlie";  // Different variable, local to otherFunction
+    printl(name);             // "Charlie"
+}
+
+otherFunction();
+printl(name);  // "Bob" - outer scope unchanged
+```
+
+### Everything is Local by Default
+
+All elements (variables, functions, classes) are **local by default** and must be explicitly marked global.
+
+| Element | Local (default) | Global |
+|---------|-----------------|--------|
+| **Variables** | `string x = "text";` | `global x = "text";` or `@x = "text";` |
+| **Functions** | `define myFunc() { }` | `global define myFunc() { }` or `define @myFunc() { }` |
+| **Typed functions** | `void myFunc() { }` | `global void myFunc() { }` or `void @myFunc() { }` |
+| **Classes** | `class MyClass { }` | `global class MyClass { }` or `class @MyClass { }` |
+
 ### Local Variables
 
 ```cssl
@@ -179,6 +215,8 @@ bool active = true;
 
 ### Global Variables
 
+Use `global` keyword or `@`/`r@` prefix to create/access global variables:
+
 ```cssl
 // Declaration with 'global' keyword
 global myGlobal = "visible everywhere";
@@ -186,11 +224,60 @@ global myGlobal = "visible everywhere";
 // Access with '@' prefix
 printl(@myGlobal);
 
-// Alternative: r@ syntax
-r@anotherGlobal = "also global";
-printl(@anotherGlobal);
+// Direct global assignment with @ or r@
+@anotherGlobal = "also global";
+r@yetAnother = "and this too";
+
+// Always read globals with @
+printl(@x);
+```
+
+### Global Functions
+
+```cssl
+// Global function with 'global' keyword
+global define helper() {
+    printl("I'm global!");
+}
+
+// Alternative: @ prefix syntax
+define @anotherHelper() {
+    printl("Also global!");
+}
+
+// Global typed function
+global void @utilityFunc(string msg) {
+    printl(msg);
+}
+```
+
+### Global Classes
+
+```cssl
+// Global class with 'global' keyword
+global class SharedClass {
+    string value;
+}
+
+// Alternative: @ prefix syntax
+class @AnotherShared {
+    int count;
+}
+
+// Instantiate global class with @ prefix
+instance = new @SharedClass();
 ```
 
+### Prefix Reference
+
+| Prefix | Name | Usage |
+|--------|------|-------|
+| `@` | Global/Module | Read global vars, access modules: `@myVar`, `@os.getcwd()` |
+| `r@` | Global Ref | Assign to global scope: `r@name = value` |
+| `$` | Shared | Access Python objects: `$counter.value` |
+| `%` | Captured | Capture value at registration: `%version` |
+| `s@` | Self-Ref | Access global structs: `s@Backend.config` |
+
 ### Shared Objects ($)
 
 Access Python objects shared via `CSSL.share()`:
@@ -215,6 +302,20 @@ version = "2.0";
 printl(savedVersion);  // Still "1.0"
 ```
 
+### Class Member Access (this->)
+
+Inside classes, use `this->` to access instance members:
+
+```cssl
+class Person {
+    string name;
+
+    void setName(string n) {
+        this->name = n;  // Instance member
+    }
+}
+```
+
 ---
 
 ## Operators
@@ -412,10 +513,16 @@ define greet(string name) {
 | `closed` | Block external CodeInfusion |
 | `private` | Block all CodeInfusion |
 | `virtual` | Import-cycle safe |
-| `meta` | Source function (must return) |
+| `meta` | Source function (any return type allowed) |
 | `super` | Force execution (no exceptions) |
 | `open` | Accept any parameters |
 | `shuffled` | Return multiple values |
+| `const` | Immutable function (like C++) |
+| `static` | Static method/function |
+| `public` | Explicitly public (default) |
+| `global` | Makes function globally accessible |
+
+**Flexible Modifier Order**: Modifiers can appear in any order before the function declaration.
 
 ```cssl
 // Ignore errors
@@ -434,6 +541,45 @@ shuffled string getNames() {
 }
 
 a, b, c = getNames();
+
+// Any order of modifiers works
+private string *@Myfunc() {
+    println("Hello from global private non-null function!");
+    return "Hey";
+}
+
+// Const function
+const void immutableFunc() {
+    printl("I'm constant");
+}
+
+// Global private const
+global private const void @MyGlobalFunc() {
+    printl("Complex modifiers in any order");
+}
+```
+
+### Typed Functions (Enforced Returns)
+
+Functions with a return type (like `int`, `string`, `vector<T>`) MUST return that type:
+
+```cssl
+// MUST return string
+string getName() {
+    return "Alice";        // OK
+    // return 42;          // Error! Expected string
+}
+
+// MUST return int
+int getAge() {
+    return 30;             // OK
+}
+
+// meta modifier bypasses type checking
+meta datastruct<string> getData() {
+    return "just a string";  // OK despite declared type
+    return 42;               // Also OK - meta allows any type
+}
 ```
 
 ### Non-Null Functions (*)
@@ -1332,7 +1478,9 @@ assert(x > 0, "x must be positive");
 
 | Syntax | Description |
 |--------|-------------|
-| `@name` | Global variable |
+| `@name` | Global variable access |
+| `@name = value` | Global variable assignment |
+| `r@name = value` | Global reference assignment |
 | `$name` | Shared Python object |
 | `%name` | Captured value |
 | `this->` | Class member access |
@@ -1342,7 +1490,12 @@ assert(x > 0, "x must be positive");
 | `&FunctionName ++` | Append to function |
 | `*func()` | Non-null function |
 | `*[type]func()` | Type exclusion filter |
+| `global class Name` | Global class declaration |
+| `class @Name` | Global class (alt syntax) |
+| `global define func()` | Global function declaration |
+| `define @func()` | Global function (alt syntax) |
+| `new @ClassName()` | Instantiate global class |
 
 ---
 
-*CSSL v3.9.1 - Developed as part of IncludeCPP*
+*CSSL v4.0.0 - Developed as part of IncludeCPP*