PyMemoryEditor 1.5.6__tar.gz → 1.5.7__tar.gz

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: PyMemoryEditor
-Version: 1.5.6
-Summary: A Python library to edit and track memory of Windows and Linux processes (32 bits and 64 bits).
+Version: 1.5.7
+Summary: Multi-platform library developed with ctypes for reading, writing and searching process memory, in a simple and friendly way with Python 3. It supports Windows and Linux (32-bit and 64-bit).
 Project-URL: Homepage, https://github.com/JeanExtreme002/PyMemoryEditor
 Author-email: Jean Loui Bernard Silva de Jesus <jeanextreme002@gmail.com>
 License-Expression: MIT
@@ -20,12 +20,12 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Security
 Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.6
 Requires-Dist: psutil
-Requires-Dist: pywin32; platform_system == 'Windows'
 Provides-Extra: tests
 Requires-Dist: pytest; extra == 'tests'
 Description-Content-Type: text/markdown
@@ -39,7 +39,7 @@ reading and writing values in the process memory.
 [![Pypi](https://img.shields.io/pypi/v/PyMemoryEditor)](https://pypi.org/project/PyMemoryEditor/)
 [![License](https://img.shields.io/pypi/l/PyMemoryEditor)](https://pypi.org/project/PyMemoryEditor/)
 [![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20Linux-8A2BE2)](https://pypi.org/project/PyMemoryEditor/)
-[![Python Version](https://img.shields.io/badge/python-3.6%20%7C%20...%20%7C%203.10%20%7C%203.11-blue)](https://pypi.org/project/PyMemoryEditor/)
+[![Python Version](https://img.shields.io/badge/python-3.6%20%7C%20...%20%7C%203.11%20%7C%203.12-blue)](https://pypi.org/project/PyMemoryEditor/)
 [![Downloads](https://static.pepy.tech/personalized-badge/pymemoryeditor?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads)](https://pypi.org/project/PyMemoryEditor/)
 
 # Installing PyMemoryEditor:

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/PyMemoryEditor/__init__.py

@@ -1,12 +1,14 @@
 # -*- coding: utf-8 -*-
 
 """
-A Python library developed with ctypes to manipulate Windows and Linux processes (32 bits and 64 bits),
-reading and writing values in the process memory.
+Multi-platform library developed with ctypes for reading, writing and
+searching process memory, in a simple and friendly way with Python 3.
+
+The package supports Windows and Linux (32-bit and 64-bit).
 """
 
 __author__ = "Jean Loui Bernard Silva de Jesus"
-__version__ = "1.5.6"
+__version__ = "1.5.7"
 
 
 from .enums import ScanTypesEnum
@@ -21,4 +23,6 @@ if "win" in sys.platform:
 # For Linux.
 else:
     from .linux.process import LinuxProcess
+    from .linux.ptrace import ptrace
+    from .linux.ptrace.enums import PtraceCommandsEnum
     OpenProcess = LinuxProcess

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/PyMemoryEditor/linux/ptrace/__init__.py

@@ -5,7 +5,7 @@
 # https://refspecs.linuxbase.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic/baselib-ptrace-1.html
 # ...
 
-from .enums import CommandsEnum
+from .enums import PtraceCommandsEnum
 
 from ctypes.util import find_library
 import ctypes
@@ -15,7 +15,7 @@ libc.ptrace.argtypes = (ctypes.c_ulong,) * 4
 libc.ptrace.restype = ctypes.c_long
 
 
-def ptrace(command: CommandsEnum, pid: int, *args: int) -> int:
+def ptrace(command: PtraceCommandsEnum, pid: int, *args: int) -> int:
     """
     Run ptrace() system call with the provided command, pid and arguments.
     """

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/PyMemoryEditor/linux/ptrace/enums.py

@@ -3,7 +3,7 @@
 from enum import Enum
 
 
-class CommandsEnum(Enum):
+class PtraceCommandsEnum(Enum):
     """
     Enum with commands for ptrace() system call.
 

pymemoryeditor-1.5.7/PyMemoryEditor/process/__init__.py

@@ -0,0 +1,145 @@
+# -*- coding: utf-8 -*-
+from abc import ABC, abstractmethod
+from typing import Generator, Optional, Tuple, Type, TypeVar, Union
+
+from ..enums import ScanTypesEnum
+from ..process.info import ProcessInfo
+
+
+T = TypeVar("T")
+
+
+class AbstractProcess(ABC):
+    """
+    Abstract class to represent a process.
+    """
+
+    @abstractmethod
+    def __init__(self, *, window_title: Optional[str] = None, process_name: Optional[str] = None, pid: Optional[int] = None):
+        """
+        :param window_title: window title of the target program.
+        :param process_name: name of the target process.
+        :param pid: process ID.
+        """
+        self._process_info = ProcessInfo()
+
+        # Set the attributes to the process.
+        if pid:
+            self._process_info.pid = pid
+
+        elif window_title:
+            self._process_info.window_title = window_title
+
+        elif process_name:
+            self._process_info.process_name = process_name
+
+        else:
+            raise TypeError("You must pass an argument to one of these parameters (window_title, process_name, pid).")
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, exc_traceback):
+        self.close()
+
+    @property
+    def pid(self) -> int:
+        return self._process_info.pid
+
+    @abstractmethod
+    def close(self) -> bool:
+        """
+        Close the process handle.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def get_memory_regions(self) -> Generator[dict, None, None]:
+        """
+        Generates dictionaries with the address, size and other
+        information of each memory region used by the process.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def search_by_value(
+        self,
+        pytype: Type[T],
+        bufflength: int,
+        value: Union[bool, int, float, str, bytes],
+        scan_type: ScanTypesEnum = ScanTypesEnum.EXACT_VALUE,
+        *,
+        progress_information: bool = False,
+        writeable_only: bool = False,
+    ) -> Generator[Union[int, Tuple[int, dict]], None, None]:
+        """
+        Search the whole memory space, accessible to the process,
+        for the provided value, returning the found addresses.
+
+        :param pytype: type of value to be queried (bool, int, float, str or bytes).
+        :param bufflength: value size in bytes (1, 2, 4, 8).
+        :param value: value to be queried (bool, int, float, str or bytes).
+        :param scan_type: the way to compare the values.
+        :param progress_information: if True, a dictionary with the progress information will be return.
+        :param writeable_only: if True, search only at writeable memory regions.
+        """
+        raise NotImplementedError()
+
+    def search_by_value_between(
+        self,
+        pytype: Type[T],
+        bufflength: int,
+        start: Union[bool, int, float, str, bytes],
+        end: Union[bool, int, float, str, bytes],
+        *,
+        not_between: bool = False,
+        progress_information: bool = False,
+        writeable_only: bool = False,
+    ) -> Generator[Union[int, Tuple[int, dict]], None, None]:
+        """
+        Search the whole memory space, accessible to the process,
+        for a value within the provided range, returning the found addresses.
+
+        :param pytype: type of value to be queried (bool, int, float, str or bytes).
+        :param bufflength: value size in bytes (1, 2, 4, 8).
+        :param start: minimum inclusive value to be queried (bool, int, float, str or bytes).
+        :param end: maximum inclusive value to be queried (bool, int, float, str or bytes).
+        :param not_between: if True, return only addresses of values that are NOT within the range.
+        :param progress_information: if True, a dictionary with the progress information will be return.
+        :param writeable_only: if True, search only at writeable memory regions.
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def read_process_memory(
+        self,
+        address: int,
+        pytype: Type[T],
+        bufflength: int
+    ) -> T:
+        """
+        Return a value from a memory address.
+
+        :param address: target memory address (ex: 0x006A9EC0).
+        :param pytype: type of the value to be received (bool, int, float, str or bytes).
+        :param bufflength: value size in bytes (1, 2, 4, 8).
+        """
+        raise NotImplementedError()
+
+    @abstractmethod
+    def write_process_memory(
+        self,
+        address: int,
+        pytype: Type[T],
+        bufflength: int,
+        value: Union[bool, int, float, str, bytes]
+    ) -> T:
+        """
+        Write a value to a memory address.
+
+        :param address: target memory address (ex: 0x006A9EC0).
+        :param pytype: type of value to be written into memory (bool, int, float, str or bytes).
+        :param bufflength: value size in bytes (1, 2, 4, 8).
+        :param value: value to be written (bool, int, float, str or bytes).
+        """
+        raise NotImplementedError()

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/PyMemoryEditor/process/util.py

@@ -4,8 +4,7 @@ import psutil
 import sys
 
 if "win" in sys.platform:
-    from win32.win32gui import FindWindow
-    from win32.win32process import GetWindowThreadProcessId
+    from ..win32.functions import GetProcessIdByWindowTitle
 
 
 def get_process_id_by_process_name(process_name: str) -> int:
@@ -24,8 +23,7 @@ def get_process_id_by_window_title(window_title: str) -> int:
     if "win" not in sys.platform:
         raise OSError("This function is compatible only with Windows OS.")
 
-    hwnd = FindWindow(None, window_title)
-    return GetWindowThreadProcessId(hwnd)[1] if hwnd else 0
+    return GetProcessIdByWindowTitle(window_title)
 
 
 def pid_exists(pid: int) -> bool:

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/README.md

@@ -7,7 +7,7 @@ reading and writing values in the process memory.
 [![Pypi](https://img.shields.io/pypi/v/PyMemoryEditor)](https://pypi.org/project/PyMemoryEditor/)
 [![License](https://img.shields.io/pypi/l/PyMemoryEditor)](https://pypi.org/project/PyMemoryEditor/)
 [![Platforms](https://img.shields.io/badge/platforms-Windows%20%7C%20Linux-8A2BE2)](https://pypi.org/project/PyMemoryEditor/)
-[![Python Version](https://img.shields.io/badge/python-3.6%20%7C%20...%20%7C%203.10%20%7C%203.11-blue)](https://pypi.org/project/PyMemoryEditor/)
+[![Python Version](https://img.shields.io/badge/python-3.6%20%7C%20...%20%7C%203.11%20%7C%203.12-blue)](https://pypi.org/project/PyMemoryEditor/)
 [![Downloads](https://static.pepy.tech/personalized-badge/pymemoryeditor?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads)](https://pypi.org/project/PyMemoryEditor/)
 
 # Installing PyMemoryEditor:

{pymemoryeditor-1.5.6 → pymemoryeditor-1.5.7}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "PyMemoryEditor"
 dynamic = ["version"]
-description = "A Python library to edit and track memory of Windows and Linux processes (32 bits and 64 bits)."
+description = "Multi-platform library developed with ctypes for reading, writing and searching process memory, in a simple and friendly way with Python 3. It supports Windows and Linux (32-bit and 64-bit)."
 authors = [
     { name = "Jean Loui Bernard Silva de Jesus", email = "jeanextreme002@gmail.com" },
 ]
@@ -36,13 +36,14 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Topic :: Scientific/Engineering",
     "Topic :: Security",
     "Topic :: System :: Monitoring"
 ]
 exclude = ["tests"]
 requires-python = ">=3.6"
-dependencies = ['pywin32 ; platform_system == "Windows"', "psutil"]
+dependencies = ["psutil"]
 
 [project.optional-dependencies]
 tests = [

pymemoryeditor-1.5.7/requirements.txt

@@ -0,0 +1,2 @@
+psutil
+pytest

pymemoryeditor-1.5.6/PyMemoryEditor/process/__init__.py

@@ -1,87 +0,0 @@
-# -*- coding: utf-8 -*-
-from abc import ABC, abstractmethod
-from typing import Optional, Type, TypeVar, Union
-
-from ..process.info import ProcessInfo
-
-
-T = TypeVar("T")
-
-
-class AbstractProcess(ABC):
-    """
-    Abstract class to represent a process.
-    """
-
-    @abstractmethod
-    def __init__(self, *, window_title: Optional[str] = None, process_name: Optional[str] = None, pid: Optional[int] = None):
-        """
-        :param window_title: window title of the target program.
-        :param process_name: name of the target process.
-        :param pid: process ID.
-        """
-        self._process_info = ProcessInfo()
-
-        # Set the attributes to the process.
-        if pid:
-            self._process_info.pid = pid
-
-        elif window_title:
-            self._process_info.window_title = window_title
-
-        elif process_name:
-            self._process_info.process_name = process_name
-
-        else:
-            raise TypeError("You must pass an argument to one of these parameters (window_title, process_name, pid).")
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_value, exc_traceback):
-        self.close()
-
-    @property
-    def pid(self) -> int:
-        return self._process_info.pid
-
-    @abstractmethod
-    def close(self) -> bool:
-        """
-        Close the process handle.
-        """
-        raise NotImplementedError()
-
-    @abstractmethod
-    def read_process_memory(
-        self,
-        address: int,
-        pytype: Type[T],
-        bufflength: int
-    ) -> T:
-        """
-        Return a value from a memory address.
-
-        :param address: target memory address (ex: 0x006A9EC0).
-        :param pytype: type of the value to be received (bool, int, float, str or bytes).
-        :param bufflength: value size in bytes (1, 2, 4, 8).
-        """
-        raise NotImplementedError()
-
-    @abstractmethod
-    def write_process_memory(
-        self,
-        address: int,
-        pytype: Type[T],
-        bufflength: int,
-        value: Union[bool, int, float, str, bytes]
-    ) -> T:
-        """
-        Write a value to a memory address.
-
-        :param address: target memory address (ex: 0x006A9EC0).
-        :param pytype: type of value to be written into memory (bool, int, float, str or bytes).
-        :param bufflength: value size in bytes (1, 2, 4, 8).
-        :param value: value to be written (bool, int, float, str or bytes).
-        """
-        raise NotImplementedError()

pymemoryeditor-1.5.6/requirements.txt

@@ -1,3 +0,0 @@
-pywin32 ; sys_platform == 'win32'
-psutil
-pytest