PyNexusAPI 1.0b0__py3-none-any.whl

pynexusapi/__init__.py

@@ -0,0 +1,429 @@
+import pyautogui as pag
+import os
+import sys
+import subprocess
+import webbrowser
+import time
+import datetime
+import keyboard
+import pyperclip
+import win32clipboard
+import win32con
+import ctypes
+from ctypes import wintypes
+import warnings
+import customtkinter as ctk
+
+print("Thanks for using PyNexusAPI by PyNoob CaSP Software (C) 2026! This message can be deleted by going into project's file and just uhm like deleting it..")
+
+class DROPFILES(ctypes.Structure):
+    _fields_ = [
+        ("pFiles", wintypes.DWORD),
+        ("pt", wintypes.POINT),
+        ("fNC", wintypes.BOOL),
+        ("fWide", wintypes.BOOL),
+    ]
+
+# WARNING: This is BETA version of PyNexusAPI, please download any updates and don't complain, again it's beta >w<
+
+osname = os.name
+if osname == "nt":
+    osnam = "Windows"
+elif osname == "posix":
+    osnam = "Linux"
+else:
+    osnam = "Unknown OS"
+
+# -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*--*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*--*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
+# PyNexusAPI makes a massive bundle:  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  * 
+# Keyboard writing - pyAutoGUI  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  * 
+# More accurate writing - keyboard  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -
+# Easy control of OS - OS  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *
+# Mouse controls - pyAutoGUI  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -
+# Easy clipboard - pyperclip  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -
+# Harder, but better clipboard - win32clipboard  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  
+# Time - yes, time is already OK with time.sleep(), but .wait is more accurate than .sleep  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  * 
+# Screen - pyAutoGUI  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  
+# ...  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  -  *  
+# And also - PyNexusAPI is way more easier! For example, win32clipboard requeares commands like OpenClipboard, pyNexusAPI in other hand, doesn't!
+# -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*--*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*--*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
+
+class Keyboard:
+
+    @staticmethod
+    def FWrite(text):
+        keyboard.write(text)
+
+    @staticmethod
+    def FHold(key):
+        keyboard.press(key)
+
+    @staticmethod
+    def FRelease(key):
+        keyboard.release(key)
+
+    @staticmethod
+    def FClick(key):
+        keyboard.send(key)
+
+    @staticmethod
+    def Write(text, wait=0):
+        pag.write(text, interval=wait)
+
+    @staticmethod
+    def Hold(key):
+        pag.keyDown(key)
+
+    @staticmethod        
+    def Release(key):
+        pag.keyUp(key)
+
+    @staticmethod        
+    def Click(key):
+        pag.press(key)
+
+    @staticmethod
+    def Combination(key1, key2):
+        pag.hotkey(key1, key2)
+
+class Mouse:
+
+    @staticmethod
+    def MoveTo(xc=500, yc=500, wait=0):
+        pag.moveTo(x=xc, y=yc, duration=wait)
+
+    @staticmethod
+    def LeftClick():
+        pag.click(button='primary')
+
+    @staticmethod
+    def RightClick():
+        pag.click(button='secondary')
+
+    @staticmethod
+    def Hold(button='primary'):
+        actual_button = button.strip().lower()
+        buttons = {
+            "right": lambda: pag.mouseDown(button='secondary'),
+            "left": lambda: pag.mouseDown(button='primary'),
+            "main": lambda: pag.mouseDown(button='primary'),
+            "primary": lambda: pag.mouseDown(button='primary'),
+            "secondary": lambda: pag.mouseDown(button='secondary')
+        }
+        btn = buttons.get(actual_button)
+        if btn:
+            btn()
+        else:
+            raise ValueError(f"'{button}' is not mapped for any known mouse button.")
+
+    @staticmethod
+    def Release(button='primary'):
+        actual_button = button.strip().lower()
+        buttons = {
+            "right": lambda: pag.mouseUp(button='secondary'),
+            "left": lambda: pag.mouseUp(button='primary'),
+            "main": lambda: pag.mouseUp(button='primary'),
+            "primary": lambda: pag.mouseUp(button='primary'),
+            "secondary": lambda: pag.mouseUp(button='secondary')
+        }
+        btn = buttons.get(actual_button)
+        if btn:
+            btn()
+        else:
+            raise ValueError(f"'{button}' is not mapped for any known mouse button.")
+
+class Clipboard:
+    @staticmethod
+    def CopyText(text):
+        pyperclip.copy(text)
+
+    @staticmethod
+    def Paste():
+        keyboard.send("ctrl+v")
+
+    @staticmethod
+    def CopyAny(file_path):
+        abs_path = os.path.abspath(file_path)
+        if not os.path.exists(abs_path):
+            raise FileNotFoundError(f"Файл по пути '{abs_path}' не существует!")
+        file_str = abs_path + "\x00\x00"
+        file_bytes = file_str.encode("utf-16-le")
+        dropfiles = DROPFILES()
+        dropfiles.pFiles = ctypes.sizeof(DROPFILES)
+        dropfiles.fWide = True
+        placed_data = bytes(dropfiles) + file_bytes
+        win32clipboard.OpenClipboard()
+        try:
+            win32clipboard.EmptyClipboard()
+            hGlobal = ctypes.windll.kernel32.GlobalAlloc(win32con.GMEM_MOVEABLE, len(placed_data))
+            pGlobal = ctypes.windll.kernel32.GlobalLock(hGlobal)
+            ctypes.memmove(pGlobal, placed_data, len(placed_data))
+            ctypes.windll.kernel32.GlobalUnlock(hGlobal)
+            win32clipboard.SetClipboardData(win32con.CF_HDROP, hGlobal)
+        finally:
+            win32clipboard.CloseClipboard()
+
+class OSC:
+    
+    @staticmethod
+    def CMD():
+        current_os = os.name
+        if current_os == "nt":
+            subprocess.Popen("start cmd", shell=True)
+        elif current_os == "posix":
+            try:
+                subprocess.Popen(["open", "-a", "Terminal"])
+            except FileNotFoundError:
+                try:
+                    subprocess.Popen(["gnome-terminal"])
+                except FileNotFoundError:
+                    raise OSError("Unable to load or locate system terminal.")
+        else:
+            raise OSError(f"OS {current_os} is unknown")
+
+    @staticmethod
+    def PowerShell():
+        current_os = os.name
+        if current_os == "nt": 
+            os.system("start powershell")
+        else: 
+            raise OSError(f"OS {current_os} is not Microsoft Windows (nt)")
+
+    @staticmethod
+    def Shutdown(wait=0):
+        if os.name == "nt":
+            os.system(f"shutdown -s -t {wait}")
+        else:
+            if wait == 0:
+                os.system("shutdown -h now")
+            else:
+                minutes = max(1, wait // 60)
+                os.system(f"shutdown -h +{minutes}")
+
+    @staticmethod
+    def Restart(wait=0):
+        if os.name == "nt":
+            os.system(f"shutdown -r -t {wait}")
+        else:
+            if wait == 0:
+                os.system("shutdown -r now")
+            else:
+                minutes = max(1, wait // 60)
+                os.system(f"shutdown -r +{minutes}")
+
+    @staticmethod
+    def OpenURL(url):
+        webbrowser.open(url)
+
+    OSName = osnam
+
+class Time:
+
+    @staticmethod
+    def Wait(seconds):
+        secs = str(seconds).strip()
+        if len(secs) == 0:
+            secs = 5.0
+            warnings.warn("Requested empty time in PyNexusAPI.Time.Wait(). Automatically converted to 5 seconds.", SyntaxWarning)
+        elif secs == "0" or secs == "0.0":
+            secs = 0.01
+            warnings.warn("Seconds can't be 0. Automatically converted to 0.01 second.", SyntaxWarning)
+        time.sleep(float(secs))
+
+    @staticmethod
+    def Update():
+        global now
+        now = datetime.datetime.now()
+now = datetime.datetime.now()
+
+class Screen:
+    
+    @staticmethod
+    def Size():
+        return pag.size()
+
+    @staticmethod
+    def PixelColor(x, y):
+        return pag.pixel(x, y)
+
+    @staticmethod
+    def Screenshot(file_name="screenshot", file_type="png"):
+        pag.screenshot(f"{file_name}.{file_type}")
+
+    @staticmethod
+    def FindImage(image_path, confidence_level=0.9):
+        try:
+            position = pag.locateCenterOnScreen(image_path, confidence=confidence_level)
+            return position
+        except:
+            return None
+
+class Windows:
+    if sys.platform != "win32":
+        raise OSError("Class PyNexusAPI.Windows can only be executed on Microsoft Windows")
+
+    @staticmethod
+    def GetActiveTitle():
+        hwnd = ctypes.windll.user32.GetForegroundWindow()
+        length = ctypes.windll.user32.GetWindowTextLengthW(hwnd)
+        buff = ctypes.create_unicode_buffer(length + 1)
+        ctypes.windll.user32.GetWindowTextW(hwnd, buff, length + 1)
+        return buff.value
+
+    @staticmethod
+    def Close(window_title):
+        hwnd = ctypes.windll.user32.FindWindowW(None, window_title)
+        if hwnd:
+            ctypes.windll.user32.PostMessageW(hwnd, 0x0010, 0, 0)
+        else:
+            raise LookupError(f"Window with title '{window_title}' not found.")
+
+    @staticmethod
+    def Minimize(window_title):
+        hwnd = ctypes.windll.user32.FindWindowW(None, window_title)
+        if hwnd:
+            ctypes.windll.user32.ShowWindow(hwnd, 6)
+        else:
+            raise LookupError(f"Window with title '{window_title}' not found.")
+
+    @staticmethod
+    def Maximize(window_title):
+        hwnd = ctypes.windll.user32.FindWindowW(None, window_title)
+        if hwnd:
+            ctypes.windll.user32.ShowWindow(hwnd, 3)
+        else:
+            raise LookupError(f"Window with title '{window_title}' not found.")
+
+    @staticmethod
+    def Hide(window_title):
+        hwnd = ctypes.windll.user32.FindWindowW(None, window_title)
+        if hwnd:
+            ctypes.windll.user32.ShowWindow(hwnd, 0)
+        else:
+            raise LookupError(f"Window with title '{window_title}' not found.")
+
+    @staticmethod
+    def Show(window_title):
+        hwnd = ctypes.windll.user32.FindWindowW(None, window_title)
+        if hwnd:
+            ctypes.windll.user32.ShowWindow(hwnd, 5)
+        else:
+            raise LookupError(f"Window with title '{window_title}' not found.")
+
+class macOS:
+    if sys.platform != "darwin":
+        raise OSError("Class PyNexusAPI.macOS can only be executed on macOS.")
+
+    @staticmethod
+    def Close(app_name):
+        cmd = f"osascript -e 'tell application \"{app_name}\" to quit'"
+        os.system(cmd)
+
+    @staticmethod
+    def Minimize(app_name):
+        cmd = f"osascript -e 'tell application \"Finder\" to set collapsed of window 1 of process \"{app_name}\" to true'"
+        os.system(cmd)
+
+    @staticmethod
+    def Maximize(app_name):
+        cmd = f"osascript -e 'tell application \"{app_name}\" to set bounds of window 1 to {{0, 0, 1920, 1080}}'"
+        os.system(cmd)
+
+    @staticmethod
+    def Notification(title, message):
+        cmd = f"osascript -e 'display notification \"{message}\" with title \"{title}\"'"
+        os.system(cmd)
+
+
+class Linux:
+    if os.name != "posix" or sys.platform == "darwin":
+        raise OSError("Class PyNexusAPI.Linux can only be executed on Linux.")
+
+    @staticmethod
+    def _check_wmctrl():
+        if os.system("command -v wmctrl > /dev/null 2>&1") != 0:
+            raise RuntimeError("Please install 'wmctrl' to control windows on Linux (sudo apt install wmctrl)")
+
+    @staticmethod
+    def Close(window_title):
+        Linux._check_wmctrl()
+        os.system(f"wmctrl -c '{window_title}'")
+
+    @staticmethod
+    def Minimize(window_title):
+        Linux._check_wmctrl()
+        os.system(f"wmctrl -r '{window_title}' -b add,shaded")
+
+    @staticmethod
+    def Maximize(window_title):
+        Linux._check_wmctrl()
+        os.system(f"wmctrl -r '{window_title}' -b add,maximized_vert,maximized_horz")
+
+    @staticmethod
+    def Notification(title, message):
+        os.system(f"notify-send '{title}' '{message}'")
+
+class Log:
+    _orig_print = print
+    _log_file = "latest.log"
+
+    @staticmethod
+    def Hook(file_name="latest.log"):
+        Log._log_file = file_name
+        def log_print(*args, **kwargs):
+            Log._orig_print(*args, **kwargs)
+            separator = kwargs.get("sep", " ")
+            end_char = kwargs.get("end", "\n")
+            log_string = separator.join(str(arg) for arg in args) + end_char
+            
+            try:
+                with open(Log._log_file, "a", encoding="utf-8") as f:
+                    f.write(log_string)
+            except Exception as e:
+                try:
+                    Log._orig_print(f"[PyNexusAPI.Log] Error: Unable to log: {e}")
+                except:
+                    pass
+        import builtins
+        builtins.print = log_print
+
+    @staticmethod
+    def Unhook():
+        import builtins
+        builtins.print = Log._orig_print
+
+class App:
+    def __init__(self, title="PyNexusAPI Window", size="600x400", theme="dark"):
+        ctk.set_appearance_mode(theme)
+        ctk.set_default_color_theme("dark-blue")
+        self.window = ctk.CTk()
+        self.window.title(title)
+        self.window.geometry(size)
+
+    @staticmethod 
+    def AddText(self, text, font_size=16, pady=10):
+        label = ctk.CTkLabel(self.window, text=text, font=("Arial", font_size))
+        label.pack(pady=pady)
+        return label
+
+    @staticmethod
+    def AddButton(self, text, command, pady=10):
+        btn = ctk.CTkButton(self.window, text=text, command=command)
+        btn.pack(pady=pady)
+        return btn
+
+    @staticmethod
+    def AddInput(self, placeholder="Input something...", width=250, pady=10):
+        entry = ctk.CTkEntry(self.window, placeholder_text=placeholder, width=width)
+        entry.pack(pady=pady)
+        return entry
+
+    @staticmethod
+    def AddCheckbox(self, text, command=None, pady=10):
+        checkbox = ctk.CTkCheckBox(self.window, text=text, command=command)
+        checkbox.pack(pady=pady)
+        return checkbox
+
+    @staticmethod
+    def Run(self):
+        self.window.mainloop()

pynexusapi-1.0b0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: PyNexusAPI
+Version: 1.0b0
+Summary: A massive bundle bridge for lazy developers to control OS, GUI, Keyboard and Mouse
+Author: Noob3ButUkr
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pyautogui
+Requires-Dist: keyboard
+Requires-Dist: pyperclip
+Requires-Dist: customtkinter
+Requires-Dist: pywin32; platform_system == "Windows"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+\# PyNexusAPI (no not GD nexus, it would be Pyfnm04API then.)
+
+The ultimate bridge between lazy developers and low-level libraries, designed for good..
+

pynexusapi-1.0b0.dist-info/RECORD

@@ -0,0 +1,5 @@
+pynexusapi/__init__.py,sha256=UGYz8L90YKODMODup58IheG-D09yVrcifh2OzaSHmDc,14910
+pynexusapi-1.0b0.dist-info/METADATA,sha256=wQnpIO4fuef6lUDimxx1Kd5ZOs8Me0eAE8mkFqFszrY,909
+pynexusapi-1.0b0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+pynexusapi-1.0b0.dist-info/top_level.txt,sha256=YwhW4mLTMMA9n-gDdsRbPRbBgpwtAXiwCTdhP5uPMuE,11
+pynexusapi-1.0b0.dist-info/RECORD,,

pynexusapi-1.0b0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pynexusapi-1.0b0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pynexusapi