See v0.0.1b2

Author: OverzealousLotus

Python/.flake8

@@ -17,7 +17,7 @@
 }
 
 
-def fruit_sell():
+def fruit_sell() -> None:
     """Where our fruit is sold."""
     global credits, threadlock, open
     if open == "YES":
@@ -40,24 +40,24 @@ def fruit_sell():
         print("")
 
 
-def shop():
+def shop() -> None:
     """Where user can purchase items."""
-    global credits, threadlock, open, USER_CHOICE, user_items, shop_items
+    global credits, threadlock, open, user_choice, user_items, shop_items
     while True:
         if open == "YES":
             threadlock.acquire()
 
-            USER_CHOICE = str(input(" \nPlease choose from these items:")).upper()
+            user_choice = str(input(" \nPlease choose from these items:")).upper()
             print("Otherwise, type anything to cancel.")
 
-            if USER_CHOICE == "UMBRELLA":
+            if user_choice == "UMBRELLA":
                 user_items.append("Umbrella")
                 shop_items.pop("Umbrella")
                 credits -= 10
-            elif USER_CHOICE == "CANDY":
+            elif user_choice == "CANDY":
                 user_items.append("Candy")
                 shop_items.pop("Candy")
-            elif USER_CHOICE == "WHEELS":
+            elif user_choice == "WHEELS":
                 user_items.append("Wheels")
                 shop_items.pop("Wheels")
         else:

…thon/Examples/Threading/threadlocking.py …ples/Advanced/Threading/threadlocking.pyPython/Examples/Threading/threadlocking.py renamed to Python/Examples/Advanced/Threading/threadlocking.py Python/Examples/Threading/threadlocking.py renamed to Python/Examples/Advanced/Threading/threadlocking.py

@@ -4,7 +4,7 @@
 from time import sleep
 
 
-def fruit_gen():
+def fruit_gen() -> None:
     """Fruit generation."""
     while True:
         our_fruit = choice([
@@ -27,7 +27,7 @@ def fruit_gen():
         print(f"One of our {our_fruit}s has been sold!")
 
 
-def income():
+def income() -> None:
     """Our income gain."""
     increase: int = 1
     while True:
@@ -36,7 +36,7 @@ def income():
         print(f"You have gained ₼{increase} from selling fruits.")
 
 
-def time():
+def time() -> None:
     """Our time passing."""
     days: int = 0
     while True:

Python/Examples/Threading/threads.py …n/Examples/Advanced/Threading/threads.pyPython/Examples/Threading/threads.py renamed to Python/Examples/Advanced/Threading/threads.py Python/Examples/Threading/threads.py renamed to Python/Examples/Advanced/Threading/threads.py

@@ -1,4 +1,4 @@
-"""Math functions"""
+"""Mathematics in Python."""
 
 __all__ = ["main"]
 __version__ = "0.1"
@@ -7,10 +7,9 @@
 import math  # Importing math
 
 
-def main():
+def main() -> None:
     """Function used to run entire program."""
-
-    pie: float = 3.13
+    pie: float = 3.14
     xanther: int = 1
     yankee: int = 2
     zulu: int = 3
@@ -24,22 +23,22 @@ def main():
     # Rounds downwards
     print(math.floor(pie))
 
-    # Notifies Python how far a value is from zero
+    # Notifies Python how far a value is from zero.
     print(abs(pie))
 
-    # Raises a value to a given power
+    # Raises a value to a given power.
     print(pow(pie, 2))
 
-    # Square roots a given value
+    # Square roots a given value.
     print(math.sqrt(pie))
 
-    # Cube roots a given valsue
+    # Cube roots a given value.
     print(math.cbrt(pie))
 
-    # Searches for the highest value
+    # Searches for the highest value.
     print(max(xanther, yankee, zulu))
 
-    # Searches for the lowest value
+    # Searches for the lowest value.
     print(min(xanther, yankee, zulu))
 
 

Python/Examples/Async/async.py

@@ -1,13 +1,12 @@
-"Built-in functions for Python"
+"""Built-in functions for Python."""
 
 __all__ = ["main"]
 __version__ = "0.1"
 __author__ = "Overzealous Lotus"
 
 
-def main():
+def main() -> None:
     """Function to run our program."""
-
     # Input()
 
     # We ask the user their name.

Python/Examples/Beginner/arithmetic.py

@@ -6,20 +6,20 @@
 __author__ = "Overzealous Lotus"
 
 
-def main_if():
+def main_if() -> None:
     """ Function to run entire program."""
 
-    # if statement
+    # <===| If |===>
 
     age: int = int(input("How old are you?:"))
 
-    if age >= 100:
+    if age >= 100:  # If statements ask if something is true.
         print("You are an elderly.")
-    elif age >= 18:   # An if statement, asking a question. Only runs if true.
+    elif age >= 18:   # Elif statements only ask if something is true, if the previous is false.
         print("Wow! You are an adult!")
-    elif age < 0:  # If its parent statement(s) are false, then this will run.
+    elif age < 0:  # Second Elif statement.
         print("You have not been born yet. Weirdo.")
-    else:  # Asks if its parent statements are all false. Only runs if true.
+    else:  # If everything fails, Else is a fallback.
         print("You are an adolescent.")
 
     temp: int = int(input("What is the temperature outside?: "))
@@ -32,54 +32,55 @@ def main_if():
     elif temp is False:
         print("Wow! The temperature is exactly zero!")
 
-    # "is" simply asks if something is something
+    # "is" simply asks if something is something.
 
-    # Matching
+    # <===| Matching |===>
 
-    # Alternatively to elif, we can use match cause statements
-
-    match age:
+    # Alternatively, Match statements are shorthand syntax for Elif blocks.
+    # They can save us space as developers, since programs can get big fast.
+    match age:  # Matches different values for "age"
         case 100 if age >= 100:
             print("Stop being old.")
         case 18 if age >= 18:
             print("You are LEGALLY an adult.")
         case 0 if age < 0:
             print("Okay, time-traveler.")
-        case _:  # _ is a placeholder
+        case _:  # _ is a placeholder. This case is a fallback.
             print("I don't know what that means.")
 
 
-def main_looping():
+def main_looping() -> None:
     """Second function to run program. ( Loops )"""
 
     name: str = ""
 
+    # <===| While |===>
     while not name:  # Freezes program until input is given
         name = str(input("What is your name?: "))
 
     print(f"Hello, {name}")
 
-    # for loop
+    # <===| For |===>
 
-    for i in range(10):  # Here, we tell Python to count up to 10.
-        print(i + 1)
+    for index in range(10):  # Here, we tell Python to count up to 10.
+        print(index + 1)
 
-    for i in range(50, 100 + 1, 2):  # Python will count from 50, to 100.
-        print(i)
+    for index in range(50, 100 + 1, 2):  # Python will count from 50, to 100.
+        print(index)
 
-    for i in "Joshua Salas":  # Prints every char in our name
-        print(i)
+    for index in "Joshua Salas":  # Prints every char in our name
+        print(index)
 
     for seconds in range(10, 0, -1):  # How about we count backwards now?
         print(seconds)
         sleep(1)
     print("Happy new year.")
 
 
-def main_control():
+def main_control() -> None:
     """Tertiary function to run program. ( Loop Control )"""
 
-    # Nesting Loops/Statements
+    # <===| Nesting |===>
 
     rows: int = int(input("How many rows?: "))
     columns: int = int(input("How many columns?: "))
@@ -90,7 +91,7 @@ def main_control():
             print(symbol, end="")  # Stops from printing to new line
         print()
 
-    # Controlling Loops
+    # <===| Loop Control |===>
 
     while True:
         name = str(input("Enter your name: "))

Python/Examples/Beginner/builtins.py

@@ -5,11 +5,8 @@
 __author__ = "Overzealous Lotus"
 
 
-def main():
+def main() -> None:
     """Primary function of our program."""
-
-    # pylint: disable=unnecessary-lambda
-
     # To define functions in Python, we use the "def" keyword, then our function name.
     # Below, we can see a few things going on in our function. In parenthesis, they list-
     # -expected values to be inputed when this function is called. Without them, our func-
@@ -18,7 +15,6 @@ def addition(
             xanther: int | float,
             yankee: int | float) -> int | float:
         """Always add Docstrings to your functions."""
-
         return xanther + yankee  # The "return" keyword returns our value.
 
     print(addition(24.5, 24.5))