PyMemoryEditor 3.0.1__tar.gz → 3.0.2__tar.gz

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: PyMemoryEditor
-Version: 3.0.1
+Version: 3.0.2
 Summary: Read, write and scan process memory in a few lines of Python — Cheat Engine-style scans, pointer chains and AOB search on Windows, Linux and macOS.
 Project-URL: Homepage, https://github.com/JeanExtreme002/PyMemoryEditor
 Project-URL: Documentation, https://pymemoryeditor.readthedocs.io
@@ -61,6 +61,8 @@ Description-Content-Type: text/markdown
 
 # PyMemoryEditor
 
+<!-- mcp-name: io.github.JeanExtreme002/PyMemoryEditor -->
+
 A pure-Python library (built on [ctypes](https://docs.python.org/3/library/ctypes.html)) that lets you **inspect, modify and search the memory of any running process in a few lines of Python** — Cheat Engine workflows on Windows, Linux and macOS!
 
 ---

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/PyMemoryEditor/__init__.py

@@ -8,7 +8,7 @@ Supported platforms: Windows, Linux and macOS (32-bit and 64-bit).
 """
 
 __author__ = "Jean Loui Bernard Silva de Jesus"
-__version__ = "3.0.1"
+__version__ = "3.0.2"
 
 import logging
 import sys

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/PyMemoryEditor/app/application.py

@@ -559,7 +559,20 @@ def main_cli(argv=None):
 
     Kept separate from :func:`main` so that process-wide change only happens
     when the app *is* the process, never when it is embedded in someone else's.
+
+    ``pymemoryeditor mcp [flags]`` runs the MCP server instead, the same as
+    ``pymemoryeditor-mcp [flags]``. MCP registries launch a PyPI package by its
+    project name (``uvx --from "PyMemoryEditor[mcp]" pymemoryeditor mcp``), so
+    this is the only command they can reach. It never touches Qt, and the
+    server keeps its own signal handling.
     """
+    if argv is None:
+        argv = sys.argv
+    if len(argv) > 1 and argv[1].strip() == "mcp":
+        from PyMemoryEditor.mcp.server import main as mcp_main
+
+        return mcp_main(argv[2:])
+
     with _scoped_signal_handler(signal.SIGINT, signal.SIG_DFL):
         return main(argv)
 

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/README.md

@@ -1,5 +1,7 @@
 # PyMemoryEditor
 
+<!-- mcp-name: io.github.JeanExtreme002/PyMemoryEditor -->
+
 A pure-Python library (built on [ctypes](https://docs.python.org/3/library/ctypes.html)) that lets you **inspect, modify and search the memory of any running process in a few lines of Python** — Cheat Engine workflows on Windows, Linux and macOS!
 
 ---

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/docs/conf.py

@@ -23,7 +23,7 @@ copyright = f"{datetime.now().year}, {author}"
 try:
     from PyMemoryEditor import __version__ as release
 except Exception:  # pragma: no cover - docs can build without the package installed
-    release = "3.0.1"
+    release = "3.0.2"
 
 version = ".".join(release.split(".")[:2])
 

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/docs/mcp.md

@@ -85,6 +85,9 @@ pymemoryeditor-mcp --allow-process game.exe   # never asks for game.exe
 pymemoryeditor-mcp --allow-any-process        # never asks at all (scripts/CI)
 ```
 
+`pymemoryeditor mcp` is the same command, flags included: it is how clients
+that install from the MCP Registry start the server.
+
 ## Flags
 
 <table>

{pymemoryeditor-3.0.1 → pymemoryeditor-3.0.2}/pyproject.toml

@@ -166,6 +166,7 @@ exclude = [
     "/.coveragerc-lib",
     "/.coveragerc-mcp",
     "/scripts",
+    "/server.json",
 ]
 
 # hatchling>=1.27 is required for PEP 639 metadata: the SPDX ``license = "MIT"``

pymemoryeditor-3.0.2/tests/mcp_server/test_registry.py

@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+
+"""
+The MCP Registry listing (server.json) and the command it makes clients run.
+
+A registry client starts a PyPI server as ``uvx <runtime args> <identifier>
+<package args>``, with the identifier being the PyPI project. So the listing
+only works while four things agree: the server name in server.json and the
+``mcp-name`` marker in the README that PyPI shows (the registry's ownership
+check), the versions in server.json and the package, and the console script
+the identifier names, which must start the server when given ``mcp``.
+"""
+
+import json
+import re
+import sys
+from pathlib import Path
+
+import pytest
+
+import PyMemoryEditor
+
+ROOT = Path(__file__).resolve().parents[2]
+
+
+@pytest.fixture(scope="module")
+def server():
+    return json.loads((ROOT / "server.json").read_text(encoding="utf-8"))
+
+
+@pytest.fixture(scope="module")
+def package(server):
+    (package,) = server["packages"]
+    return package
+
+
+def test_readme_carries_the_registry_name(server):
+    readme = (ROOT / "README.md").read_text(encoding="utf-8")
+
+    assert re.findall(r"mcp-name: (\S+) -->", readme) == [server["name"]]
+
+
+def test_versions_follow_the_package(server, package):
+    version = PyMemoryEditor.__version__
+
+    assert server["version"] == package["version"] == version
+    assert {"type": "named", "name": "--from"}.items() <= package["runtimeArguments"][0].items()
+    assert package["runtimeArguments"][0]["value"] == "PyMemoryEditor[mcp]==" + version
+
+
+def test_the_command_a_client_builds_starts_the_server(package):
+    pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    scripts = re.search(r"\[project\.scripts\](.*?)\n\[", pyproject, re.S).group(1)
+
+    # uvx looks the executable up by its exact name, and the console scripts
+    # are lowercase: "PyMemoryEditor" would not be found on Linux.
+    assert re.search(r'^{} = "PyMemoryEditor\.app\.application:main_cli"$'.format(package["identifier"]), scripts, re.M)
+    assert package["runtimeHint"] == "uvx"
+    assert package["packageArguments"] == [{"type": "positional", "value": "mcp"}]
+    assert package["transport"] == {"type": "stdio"}
+
+
+def test_description_fits_the_registry_limit(server):
+    # The registry rejects a description over 100 characters at publish time.
+    assert len(server["description"]) <= 100
+
+
+def test_mcp_subcommand_runs_the_server_without_qt(monkeypatch):
+    from PyMemoryEditor.app import application
+    from PyMemoryEditor.mcp import server as mcp_server
+
+    received = []
+    monkeypatch.setattr(mcp_server, "main", lambda argv: received.append(list(argv)) or 0)
+    monkeypatch.setattr(application, "main", lambda argv: pytest.fail("the Qt app started"))
+    monkeypatch.setitem(sys.modules, "PySide6", None)  # any Qt import would raise
+
+    assert application.main_cli(["pymemoryeditor", "mcp", "--read-only", "--allow-process", "game.exe"]) == 0
+    assert received == [["--read-only", "--allow-process", "game.exe"]]
+
+
+def test_other_arguments_still_reach_the_app(monkeypatch):
+    from PyMemoryEditor.app import application
+
+    received = []
+    monkeypatch.setattr(application, "main", lambda argv: received.append(argv))
+
+    application.main_cli(["pymemoryeditor", "--version"])
+    assert received == [["pymemoryeditor", "--version"]]