Name changes and docstrings

Author: ElBe-Plaq

Main/_types.py

@@ -1,6 +1,6 @@
 """
 I Language types.
-Version: 0.1.1
+Version: 0.1.2
 
 Copyright (c) 2023-present ElBe Development.
 
@@ -88,20 +88,6 @@ def __init__(self, value: str) -> None:
         super().__init__(value, _Any)
 
 
-class Array(BaseType):
-    """
-    Array type.
-    """
-
-    def __init__(self, value: str) -> None:
-        """Initializes an array type.
-
-        :param value: Value of the object to check for array value.
-        """
-
-        super().__init__(value, builtins.list)
-
-
 @final
 class Bool(BaseType):
     """
@@ -221,18 +207,32 @@ def __init__(self, value: str) -> None:
 
 
 @final
-class List(Array):
+class List(BaseType):
     """
-    Array type.
+    List type.
     """
 
     def __init__(self, value: str) -> None:
-        """Initializes an array type.
+        """Initializes a list type.
 
-        :param value: Value of the object to check for array value.
+        :param value: Value of the object to check for list value.
         """
 
-        super().__init__(value)
+        super().__init__(value, builtins.list)
+
+
+class Null(BaseType):
+    """
+    None type.
+    """
+
+    def __init__(self, value: str) -> None:
+        """Initializes a none type.
+
+        :param value: Value of the object to check for none value.
+        """
+
+        super().__init__(value)  # TODO (ElBe): Find null type
 
 
 class Str(BaseType):

Main/lexer.py

@@ -47,7 +47,8 @@
 SEPARATORS: Final[List[str]] = [" ", "\t", "\n"]
 DOUBLE_MARKS: Final[Dict[str, str]] = {
     "==": "EQUAL",
-    "===": "TYPE_EQUAL",
+    "<=": "LESS_EQUALS",
+    ">=": "GREATER_EQUALS",
     "++": "COUNT_UP",
     "--": "COUNT_DOWN",
 }
@@ -88,7 +89,6 @@
 }
 BASE_TYPES: Final[List[str]] = [
     "any",
-    "array",
     "bool",
     "complex",
     "dict",
@@ -100,8 +100,7 @@
     "list",
     "str",
     "string",
-    "None",
-    "Null",
+    "null",
 ]
 
 

Modules/Random.ilang

@@ -36,6 +36,7 @@ import _core
 ////////////////////
 
 int randint(int minimum, int maximum) {
+
     return _core.Random.randint(minimum, maximum)
 }
 
@@ -44,8 +45,34 @@ int randint(int minimum, int maximum) {
 // CHOICES //
 /////////////
 
+/*
+* Returns a random value from a given list.
+*
+* @params
+* iterable (list): List to return a random choice from.
+* choices  (list): Choices to return form the iterable. If choices is bigger than the iterable, the remaining values will be skipped.
+*
+* @return
+* Any: Chosen object(s) from the iterable.
+*/
 function choices(list iterable, int choices = 1) {
     return _core.Random.choices(iterable, choices)
 }
 
-// TODO (ElBe): Add shuffle
+
+/////////////
+// SHUFFLE //
+/////////////
+
+/*
+* Returns a shuffled version of the given list.
+*
+* @params
+* iterable (list): List to shuffle.
+*
+* @return
+* list: Shuffled list.
+*/
+list shuffle(list iterable) {
+    return _code.Random.shuffle(iterable)
+}