IncludeCPP 3.5.0__py3-none-any.whl → 3.7.1__py3-none-any.whl

includecpp/core/cssl/cssl_types.py

@@ -546,16 +546,300 @@ class Array(list):
         return len(self)
 
 
+class List(list):
+    """Python-like list with all standard operations.
+
+    Works exactly like Python lists with additional CSSL methods.
+
+    Usage:
+        list myList;
+        myList.append("item");
+        myList.insert(0, "first");
+        myList.pop();
+        myList.find("item");  # Returns index or -1
+    """
+
+    def __init__(self, element_type: str = 'dynamic'):
+        super().__init__()
+        self._element_type = element_type
+
+    def length(self) -> int:
+        """Return list length"""
+        return len(self)
+
+    def size(self) -> int:
+        """Return list size (alias for length)"""
+        return len(self)
+
+    def isEmpty(self) -> bool:
+        """Check if list is empty"""
+        return len(self) == 0
+
+    def first(self) -> Any:
+        """Get first element"""
+        return self[0] if self else None
+
+    def last(self) -> Any:
+        """Get last element"""
+        return self[-1] if self else None
+
+    def at(self, index: int) -> Any:
+        """Get item at index (safe access)"""
+        if 0 <= index < len(self):
+            return self[index]
+        return None
+
+    def set(self, index: int, value: Any) -> 'List':
+        """Set item at index"""
+        if 0 <= index < len(self):
+            self[index] = value
+        return self
+
+    def add(self, item: Any) -> 'List':
+        """Add item to end (alias for append)"""
+        self.append(item)
+        return self
+
+    def push(self, item: Any) -> 'List':
+        """Push item to end (alias for append)"""
+        self.append(item)
+        return self
+
+    def find(self, item: Any) -> int:
+        """Find index of item (-1 if not found)"""
+        try:
+            return self.index(item)
+        except ValueError:
+            return -1
+
+    def contains(self, item: Any) -> bool:
+        """Check if list contains item"""
+        return item in self
+
+    def indexOf(self, item: Any) -> int:
+        """Find index of item (-1 if not found)"""
+        return self.find(item)
+
+    def lastIndexOf(self, item: Any) -> int:
+        """Find last index of item (-1 if not found)"""
+        for i in range(len(self) - 1, -1, -1):
+            if self[i] == item:
+                return i
+        return -1
+
+    def removeAt(self, index: int) -> Any:
+        """Remove and return item at index"""
+        if 0 <= index < len(self):
+            return self.pop(index)
+        return None
+
+    def removeValue(self, value: Any) -> bool:
+        """Remove first occurrence of value"""
+        try:
+            self.remove(value)
+            return True
+        except ValueError:
+            return False
+
+    def removeAll(self, value: Any) -> int:
+        """Remove all occurrences of value, return count"""
+        count = 0
+        while value in self:
+            self.remove(value)
+            count += 1
+        return count
+
+    def slice(self, start: int, end: int = None) -> 'List':
+        """Return slice of list"""
+        result = List(self._element_type)
+        if end is None:
+            result.extend(self[start:])
+        else:
+            result.extend(self[start:end])
+        return result
+
+    def join(self, separator: str = ',') -> str:
+        """Join elements into string"""
+        return separator.join(str(item) for item in self)
+
+    def unique(self) -> 'List':
+        """Return list with unique elements"""
+        result = List(self._element_type)
+        seen = set()
+        for item in self:
+            key = item if isinstance(item, (int, str, float, bool)) else id(item)
+            if key not in seen:
+                seen.add(key)
+                result.append(item)
+        return result
+
+    def sorted(self, reverse: bool = False) -> 'List':
+        """Return sorted copy"""
+        result = List(self._element_type)
+        result.extend(sorted(self, reverse=reverse))
+        return result
+
+    def reversed(self) -> 'List':
+        """Return reversed copy"""
+        result = List(self._element_type)
+        result.extend(reversed(self))
+        return result
+
+    def shuffle(self) -> 'List':
+        """Shuffle list in place"""
+        import random
+        random.shuffle(self)
+        return self
+
+    def fill(self, value: Any, count: int = None) -> 'List':
+        """Fill list with value"""
+        if count is None:
+            for i in range(len(self)):
+                self[i] = value
+        else:
+            self.clear()
+            self.extend([value] * count)
+        return self
+
+    def begin(self) -> int:
+        """Return iterator to beginning"""
+        return 0
+
+    def end(self) -> int:
+        """Return iterator to end"""
+        return len(self)
+
+
+class Dictionary(dict):
+    """Python-like dictionary with all standard operations.
+
+    Works exactly like Python dicts with additional CSSL methods.
+
+    Usage:
+        dictionary myDict;
+        myDict.set("key", "value");
+        myDict.get("key");
+        myDict.keys();
+        myDict.values();
+    """
+
+    def __init__(self, key_type: str = 'dynamic', value_type: str = 'dynamic'):
+        super().__init__()
+        self._key_type = key_type
+        self._value_type = value_type
+
+    def length(self) -> int:
+        """Return dictionary size"""
+        return len(self)
+
+    def size(self) -> int:
+        """Return dictionary size (alias for length)"""
+        return len(self)
+
+    def isEmpty(self) -> bool:
+        """Check if dictionary is empty"""
+        return len(self) == 0
+
+    def set(self, key: Any, value: Any) -> 'Dictionary':
+        """Set key-value pair"""
+        self[key] = value
+        return self
+
+    def hasKey(self, key: Any) -> bool:
+        """Check if key exists"""
+        return key in self
+
+    def hasValue(self, value: Any) -> bool:
+        """Check if value exists"""
+        return value in self.values()
+
+    def remove(self, key: Any) -> Any:
+        """Remove and return value for key"""
+        return self.pop(key, None)
+
+    def getOrDefault(self, key: Any, default: Any = None) -> Any:
+        """Get value or default if not found"""
+        return self.get(key, default)
+
+    def setDefault(self, key: Any, default: Any) -> Any:
+        """Set default if key doesn't exist, return value"""
+        if key not in self:
+            self[key] = default
+        return self[key]
+
+    def merge(self, other: dict) -> 'Dictionary':
+        """Merge another dictionary into this one"""
+        self.update(other)
+        return self
+
+    def keysList(self) -> list:
+        """Return keys as list"""
+        return list(self.keys())
+
+    def valuesList(self) -> list:
+        """Return values as list"""
+        return list(self.values())
+
+    def itemsList(self) -> list:
+        """Return items as list of tuples"""
+        return list(self.items())
+
+    def filter(self, predicate: Callable[[Any, Any], bool]) -> 'Dictionary':
+        """Filter dictionary by predicate(key, value)"""
+        result = Dictionary(self._key_type, self._value_type)
+        for k, v in self.items():
+            if predicate(k, v):
+                result[k] = v
+        return result
+
+    def map(self, func: Callable[[Any, Any], Any]) -> 'Dictionary':
+        """Apply function to all values"""
+        result = Dictionary(self._key_type, self._value_type)
+        for k, v in self.items():
+            result[k] = func(k, v)
+        return result
+
+    def forEach(self, func: Callable[[Any, Any], None]) -> 'Dictionary':
+        """Execute function for each key-value pair"""
+        for k, v in self.items():
+            func(k, v)
+        return self
+
+    def invert(self) -> 'Dictionary':
+        """Swap keys and values"""
+        result = Dictionary(self._value_type, self._key_type)
+        for k, v in self.items():
+            result[v] = k
+        return result
+
+    def find(self, value: Any) -> Optional[Any]:
+        """Find first key with given value"""
+        for k, v in self.items():
+            if v == value:
+                return k
+        return None
+
+    def findAll(self, value: Any) -> list:
+        """Find all keys with given value"""
+        return [k for k, v in self.items() if v == value]
+
+
 class Shuffled(list):
     """Unorganized fast storage for multiple returns.
 
     Stores data unorganized for fast and efficient access.
     Supports receiving multiple return values from functions.
+    Can be used as a function modifier to allow multiple returns.
 
     Usage:
         shuffled<string> results;
         results +<== someFunc();  # Catches all returns
         results.read()  # Returns all content as list
+
+        # As return modifier:
+        shuffled string getData() {
+            return "name", "address";  # Returns multiple values
+        }
     """
 
     def __init__(self, element_type: str = 'dynamic'):
@@ -575,6 +859,49 @@ class Shuffled(list):
             self.append(result)
         return self
 
+    def add(self, *items) -> 'Shuffled':
+        """Add one or more items"""
+        for item in items:
+            if isinstance(item, (list, tuple)):
+                self.extend(item)
+            else:
+                self.append(item)
+        return self
+
+    def first(self) -> Any:
+        """Get first element"""
+        return self[0] if self else None
+
+    def last(self) -> Any:
+        """Get last element"""
+        return self[-1] if self else None
+
+    def length(self) -> int:
+        """Return shuffled length"""
+        return len(self)
+
+    def isEmpty(self) -> bool:
+        """Check if empty"""
+        return len(self) == 0
+
+    def contains(self, item: Any) -> bool:
+        """Check if contains item"""
+        return item in self
+
+    def at(self, index: int) -> Any:
+        """Get item at index"""
+        if 0 <= index < len(self):
+            return self[index]
+        return None
+
+    def toList(self) -> list:
+        """Convert to plain list"""
+        return list(self)
+
+    def toTuple(self) -> tuple:
+        """Convert to tuple"""
+        return tuple(self)
+
 
 class Iterator:
     """Advanced iterator with programmable tasks.
@@ -944,10 +1271,242 @@ def create_array(element_type: str = 'dynamic') -> Array:
     return Array(element_type)
 
 
+def create_list(element_type: str = 'dynamic') -> List:
+    """Create a List object"""
+    return List(element_type)
+
+
+def create_dictionary(key_type: str = 'dynamic', value_type: str = 'dynamic') -> Dictionary:
+    """Create a Dictionary object"""
+    return Dictionary(key_type, value_type)
+
+
+class Map(dict):
+    """C++ style map container with ordered key-value pairs.
+
+    Similar to Dictionary but with C++ map semantics.
+    Keys are maintained in sorted order.
+
+    Usage:
+        map<string, int> ages;
+        ages.insert("Alice", 30);
+        ages.find("Alice");
+        ages.erase("Alice");
+    """
+
+    def __init__(self, key_type: str = 'dynamic', value_type: str = 'dynamic'):
+        super().__init__()
+        self._key_type = key_type
+        self._value_type = value_type
+
+    def insert(self, key: Any, value: Any) -> 'Map':
+        """Insert key-value pair (C++ style)"""
+        self[key] = value
+        return self
+
+    def find(self, key: Any) -> Optional[Any]:
+        """Find value by key, returns None if not found (C++ style)"""
+        return self.get(key, None)
+
+    def erase(self, key: Any) -> bool:
+        """Erase key-value pair, returns True if existed"""
+        if key in self:
+            del self[key]
+            return True
+        return False
+
+    def contains(self, key: Any) -> bool:
+        """Check if key exists (C++20 style)"""
+        return key in self
+
+    def count(self, key: Any) -> int:
+        """Return 1 if key exists, 0 otherwise (C++ style)"""
+        return 1 if key in self else 0
+
+    def size(self) -> int:
+        """Return map size"""
+        return len(self)
+
+    def empty(self) -> bool:
+        """Check if map is empty"""
+        return len(self) == 0
+
+    def at(self, key: Any) -> Any:
+        """Get value at key, raises error if not found (C++ style)"""
+        if key not in self:
+            raise KeyError(f"Key '{key}' not found in map")
+        return self[key]
+
+    def begin(self) -> Optional[tuple]:
+        """Return first key-value pair"""
+        if len(self) == 0:
+            return None
+        first_key = next(iter(self))
+        return (first_key, self[first_key])
+
+    def end(self) -> Optional[tuple]:
+        """Return last key-value pair"""
+        if len(self) == 0:
+            return None
+        last_key = list(self.keys())[-1]
+        return (last_key, self[last_key])
+
+    def lower_bound(self, key: Any) -> Optional[Any]:
+        """Find first key >= given key (for sorted keys)"""
+        sorted_keys = sorted(self.keys())
+        for k in sorted_keys:
+            if k >= key:
+                return k
+        return None
+
+    def upper_bound(self, key: Any) -> Optional[Any]:
+        """Find first key > given key (for sorted keys)"""
+        sorted_keys = sorted(self.keys())
+        for k in sorted_keys:
+            if k > key:
+                return k
+        return None
+
+
+def create_map(key_type: str = 'dynamic', value_type: str = 'dynamic') -> Map:
+    """Create a Map object"""
+    return Map(key_type, value_type)
+
+
+class CSSLClass:
+    """Represents a CSSL class definition.
+
+    Stores class name, member variables, methods, and constructor.
+    Used by the runtime to instantiate CSSLInstance objects.
+    """
+
+    def __init__(self, name: str, members: Dict[str, Any] = None,
+                 methods: Dict[str, Any] = None, constructor: Any = None):
+        self.name = name
+        self.members = members or {}  # Default member values/types
+        self.methods = methods or {}  # Method AST nodes
+        self.constructor = constructor  # Constructor AST node
+
+    def __repr__(self):
+        return f"<CSSLClass '{self.name}' with {len(self.methods)} methods>"
+
+
+class CSSLInstance:
+    """Represents an instance of a CSSL class.
+
+    Holds instance member values and provides access to class methods.
+    Supports this-> member access pattern.
+    """
+
+    def __init__(self, class_def: CSSLClass):
+        self._class = class_def
+        self._members: Dict[str, Any] = {}
+        # Initialize members with defaults from class definition
+        for name, default in class_def.members.items():
+            if isinstance(default, dict):
+                # Type declaration with optional default
+                member_type = default.get('type')
+                member_default = default.get('default')
+
+                if member_default is not None:
+                    self._members[name] = member_default
+                elif member_type:
+                    # Create instance of container types
+                    self._members[name] = self._create_default_for_type(member_type)
+                else:
+                    self._members[name] = None
+            else:
+                self._members[name] = default
+
+    def _create_default_for_type(self, type_name: str) -> Any:
+        """Create a default value for a given type name."""
+        # Container types
+        if type_name == 'map':
+            return Map()
+        elif type_name in ('stack',):
+            return Stack()
+        elif type_name in ('vector',):
+            return Vector()
+        elif type_name in ('array',):
+            return Array()
+        elif type_name in ('list',):
+            return List()
+        elif type_name in ('dictionary', 'dict'):
+            return Dictionary()
+        elif type_name == 'datastruct':
+            return DataStruct()
+        elif type_name == 'dataspace':
+            return DataSpace()
+        elif type_name == 'shuffled':
+            return Shuffled()
+        elif type_name == 'iterator':
+            return Iterator()
+        elif type_name == 'combo':
+            return Combo()
+        # Primitive types
+        elif type_name == 'int':
+            return 0
+        elif type_name == 'float':
+            return 0.0
+        elif type_name == 'string':
+            return ""
+        elif type_name == 'bool':
+            return False
+        elif type_name == 'json':
+            return {}
+        return None
+
+    def get_member(self, name: str) -> Any:
+        """Get member value by name"""
+        if name in self._members:
+            return self._members[name]
+        raise AttributeError(f"'{self._class.name}' has no member '{name}'")
+
+    def set_member(self, name: str, value: Any) -> None:
+        """Set member value by name"""
+        self._members[name] = value
+
+    def has_member(self, name: str) -> bool:
+        """Check if member exists"""
+        return name in self._members
+
+    def get_method(self, name: str) -> Any:
+        """Get method AST node by name"""
+        if name in self._class.methods:
+            return self._class.methods[name]
+        raise AttributeError(f"'{self._class.name}' has no method '{name}'")
+
+    def has_method(self, name: str) -> bool:
+        """Check if method exists"""
+        return name in self._class.methods
+
+    def __getattr__(self, name: str) -> Any:
+        """Allow direct attribute access for members"""
+        if name.startswith('_'):
+            raise AttributeError(name)
+        if name in self._members:
+            return self._members[name]
+        raise AttributeError(f"'{self._class.name}' has no member '{name}'")
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        """Allow direct attribute setting for members"""
+        if name.startswith('_'):
+            object.__setattr__(self, name, value)
+        else:
+            if hasattr(self, '_members'):
+                self._members[name] = value
+            else:
+                object.__setattr__(self, name, value)
+
+    def __repr__(self):
+        return f"<CSSLInstance of '{self._class.name}'>"
+
+
 __all__ = [
     'DataStruct', 'Shuffled', 'Iterator', 'Combo', 'DataSpace', 'OpenQuote',
-    'OpenFind', 'Parameter', 'Stack', 'Vector', 'Array',
+    'OpenFind', 'Parameter', 'Stack', 'Vector', 'Array', 'List', 'Dictionary', 'Map',
+    'CSSLClass', 'CSSLInstance',
     'create_datastruct', 'create_shuffled', 'create_iterator',
     'create_combo', 'create_dataspace', 'create_openquote', 'create_parameter',
-    'create_stack', 'create_vector', 'create_array'
+    'create_stack', 'create_vector', 'create_array', 'create_list', 'create_dictionary', 'create_map'
 ]