Merge pull request #4 from I-Language-Development/dev

Update from Dev

Author: ElBe-Plaq

Main/lexer.py

@@ -37,6 +37,7 @@
     Final,
 )
 
+import Main._types
 
 #############
 # CONSTANTS #
@@ -268,7 +269,7 @@ def gettoken(string: str, line: int, column: int) -> LexerToken | None:
 
             index += 1
 
-        return [str(token) for token in self.tokens if token is not None]
+        return [str(token) for token in self.tokens if token is not None]  # TODO (ElBe): Change it back
 
 
 if __name__ == "__main__":

Modules/Math.ilang

@@ -35,17 +35,26 @@ import _core
 // CONSTANTS //
 ///////////////
 
-const float Pi       = 3.141592653589793238462643383279502884197
-const float E        = 2.718281828459045235360287471352662497757
-const float Infinite = _core.Math.Infinite
+const float pi       = 3.141592653589793238462643383279502884197
+const float e        = 2.718281828459045235360287471352662497757
+const float infinite = _core.Math.Infinite
 
 
 ///////////
 // ROUND //
 ///////////
 
+/*
+* Returns the rounded version of the number.
+*
+* @params
+* number (float): Number to round.
+*
+* @return
+* int: Rounded number.
+*/
 int round(float number) {
-    return _core.Math.round(number)
+    return _core.Math._round(number)
 }
 
 // Todo (ElBe): Add floor and ceil

Modules/Random.ilang

@@ -35,6 +35,16 @@ import _core
 // RANDOM INTEGER //
 ////////////////////
 
+/*
+* Returns a randomly generated number.
+*
+* @params
+* minimum (int): Lowest possible value for the number generation.
+* maximum (int): Highest possible value for the number generation.
+*
+* @return
+* int: Randomly generated number.
+*/
 int randint(int minimum, int maximum) {
 
     return _core.Random.randint(minimum, maximum)
@@ -50,10 +60,10 @@ int randint(int minimum, int maximum) {
 *
 * @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.
+* choices  (list): Number of 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.
+* Any: Random value(s) from the iterable.
 */
 function choices(list iterable, int choices = 1) {
     return _core.Random.choices(iterable, choices)

Modules/_core/Math.py

@@ -0,0 +1,54 @@
+"""
+I Language Math module.
+Version: 0.1.0
+
+Copyright (c) 2023-present ElBe Development.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the 'Software'),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
+###########
+# IMPORTS #
+###########
+
+import math
+from typing import (
+    Final,
+)
+
+
+#############
+# CONSTANTS #
+#############
+
+Infinite: Final[float] = float("inf")
+
+
+#########
+# ROUND #
+#########
+
+def _round(number: float) -> int:
+    """Rounds a number.
+
+    :param number: Number to round.
+    :return: Rounded number.
+    """
+
+    return round(number)

Modules/_core/Random.py

@@ -0,0 +1,72 @@
+"""
+I Language Random module.
+Version: 0.1.0
+
+Copyright (c) 2023-present ElBe Development.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the 'Software'),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
+###########
+# IMPORTS #
+###########
+
+import random
+from typing import (
+    Any,
+    List,
+)
+
+
+###########
+# RANDINT #
+###########
+
+def randint(minimum: int, maximum: int) -> int:
+    """Generates a random number.
+
+    :param minimum: Lowest possible value.
+    :param maximum: Highest possible value.
+    :return: Random number between minimum and maximum.
+    """
+
+    return random.randint(minimum, maximum)
+
+
+###########
+# CHOICES #
+###########
+
+def choices(iterable: List, choices: int = 1) -> Any:
+    """Returns a random value from a given list.
+
+    :param iterable: List to return a random value from.
+    :param choices: Number of choices to return form the iterable. If choices is bigger than the iterable, the remaining
+                    values will be skipped.
+    :return: Random value(s) from iterable.
+    """
+
+    if choices == 1:
+        return random.choice(iterable)
+    else:
+        return random.choices(iterable)
+
+###########
+# SHUFFLE #
+###########

Modules/_core/__init__.py

@@ -0,0 +1,33 @@
+"""
+I Language core.
+Version: 0.1.0
+
+Copyright (c) 2023-present ElBe Development.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the 'Software'),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+"""
+
+###########
+# IMPORTS #
+###########
+
+from Modules._core import (
+    Math,
+    Random,
+)