toolright 0.0.1__tar.gz

toolright-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toolright contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

toolright-0.0.1/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: toolright
+Version: 0.0.1
+Summary: Does your agent pick the right tool? Test MCP tool descriptions against real models. Python launcher for the Toolright Node.js CLI.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ab-rar-6024/toolright
+Project-URL: Repository, https://github.com/ab-rar-6024/toolright
+Project-URL: Issues, https://github.com/ab-rar-6024/toolright/issues
+Project-URL: npm, https://www.npmjs.com/package/toolright
+Keywords: mcp,model-context-protocol,llm,evaluation,tool-calling,agents
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: JavaScript
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# toolright (Python launcher)
+
+**Does your agent pick the right tool?** Test your MCP server's tool descriptions against real models, then keep only the rewrites that measurably help.
+
+This package is a thin Python launcher for [Toolright](https://github.com/ab-rar-6024/toolright), which is a **Node.js** tool. It does not reimplement anything: `pip install toolright` gives you a `toolright` command that runs the npm package of the **same version** through `npx`.
+
+**You need Node.js 20+** on your PATH (it provides `npx`).
+
+```bash
+pip install toolright
+
+toolright lint -- python my_mcp_server.py       # Tier 1: no model, no API key
+toolright eval -m ollama:qwen2.5:3b --prompts prompts.json -- python my_mcp_server.py
+```
+
+The first run downloads the pinned npm package once; later runs use npm's cache.
+
+Full documentation, the three tiers, security model and limits: <https://github.com/ab-rar-6024/toolright>
+
+Prefer Node directly? `npx toolright ...` or `npm install -g toolright`.
+
+> Pre-release (0.0.1). Model-facing code has not yet been run against live provider APIs. See the main README for the honest status.

toolright-0.0.1/README.md

@@ -0,0 +1,22 @@
+# toolright (Python launcher)
+
+**Does your agent pick the right tool?** Test your MCP server's tool descriptions against real models, then keep only the rewrites that measurably help.
+
+This package is a thin Python launcher for [Toolright](https://github.com/ab-rar-6024/toolright), which is a **Node.js** tool. It does not reimplement anything: `pip install toolright` gives you a `toolright` command that runs the npm package of the **same version** through `npx`.
+
+**You need Node.js 20+** on your PATH (it provides `npx`).
+
+```bash
+pip install toolright
+
+toolright lint -- python my_mcp_server.py       # Tier 1: no model, no API key
+toolright eval -m ollama:qwen2.5:3b --prompts prompts.json -- python my_mcp_server.py
+```
+
+The first run downloads the pinned npm package once; later runs use npm's cache.
+
+Full documentation, the three tiers, security model and limits: <https://github.com/ab-rar-6024/toolright>
+
+Prefer Node directly? `npx toolright ...` or `npm install -g toolright`.
+
+> Pre-release (0.0.1). Model-facing code has not yet been run against live provider APIs. See the main README for the honest status.

toolright-0.0.1/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "toolright"
+version = "0.0.1"
+description = "Does your agent pick the right tool? Test MCP tool descriptions against real models. Python launcher for the Toolright Node.js CLI."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["mcp", "model-context-protocol", "llm", "evaluation", "tool-calling", "agents"]
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: JavaScript",
+  "Topic :: Software Development :: Testing",
+]
+
+[project.urls]
+Homepage = "https://github.com/ab-rar-6024/toolright"
+Repository = "https://github.com/ab-rar-6024/toolright"
+Issues = "https://github.com/ab-rar-6024/toolright/issues"
+npm = "https://www.npmjs.com/package/toolright"
+
+[project.scripts]
+toolright = "toolright:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

toolright-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

toolright-0.0.1/src/toolright/__init__.py

@@ -0,0 +1,57 @@
+"""Python launcher for the Toolright CLI.
+
+Toolright is a Node.js tool (https://www.npmjs.com/package/toolright). This package
+exists so that ``pip install toolright`` gives you a ``toolright`` command. It does not
+reimplement anything: it runs the npm package of the SAME version through ``npx``.
+
+Requirements: Node.js 20+ (which provides ``npx``) on your PATH.
+"""
+
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from typing import List, Optional, Sequence
+
+__version__ = "0.0.1"
+
+NPM_PACKAGE = "toolright"
+_GUARD = "TOOLRIGHT_PY_LAUNCHER"
+
+
+def build_command(npx: str, args: Sequence[str]) -> List[str]:
+    """The exact command we run. The npm version is pinned to this package's version."""
+    return [npx, "--yes", f"{NPM_PACKAGE}@{__version__}", *args]
+
+
+def main(argv: Optional[Sequence[str]] = None) -> int:
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if os.environ.get(_GUARD):
+        sys.stderr.write("toolright: launcher recursion detected; refusing to continue.\n")
+        return 1
+
+    npx = shutil.which("npx")
+    if shutil.which("node") is None or npx is None:
+        sys.stderr.write(
+            "toolright needs Node.js 20+ (it provides `npx`), and it was not found on your PATH.\n"
+            "Install Node.js from https://nodejs.org, then run this command again.\n"
+        )
+        return 127
+
+    env = dict(os.environ)
+    env[_GUARD] = "1"
+    try:
+        # A list, never a shell string: arguments are passed through untouched.
+        return subprocess.call(build_command(npx, args), env=env)
+    except KeyboardInterrupt:
+        return 130
+    except OSError as exc:
+        sys.stderr.write(f"toolright: could not start npx: {exc}\n")
+        return 1
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())

toolright-0.0.1/src/toolright/__main__.py

@@ -0,0 +1,3 @@
+from . import main
+
+raise SystemExit(main())

toolright-0.0.1/src/toolright.egg-info/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: toolright
+Version: 0.0.1
+Summary: Does your agent pick the right tool? Test MCP tool descriptions against real models. Python launcher for the Toolright Node.js CLI.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ab-rar-6024/toolright
+Project-URL: Repository, https://github.com/ab-rar-6024/toolright
+Project-URL: Issues, https://github.com/ab-rar-6024/toolright/issues
+Project-URL: npm, https://www.npmjs.com/package/toolright
+Keywords: mcp,model-context-protocol,llm,evaluation,tool-calling,agents
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: JavaScript
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# toolright (Python launcher)
+
+**Does your agent pick the right tool?** Test your MCP server's tool descriptions against real models, then keep only the rewrites that measurably help.
+
+This package is a thin Python launcher for [Toolright](https://github.com/ab-rar-6024/toolright), which is a **Node.js** tool. It does not reimplement anything: `pip install toolright` gives you a `toolright` command that runs the npm package of the **same version** through `npx`.
+
+**You need Node.js 20+** on your PATH (it provides `npx`).
+
+```bash
+pip install toolright
+
+toolright lint -- python my_mcp_server.py       # Tier 1: no model, no API key
+toolright eval -m ollama:qwen2.5:3b --prompts prompts.json -- python my_mcp_server.py
+```
+
+The first run downloads the pinned npm package once; later runs use npm's cache.
+
+Full documentation, the three tiers, security model and limits: <https://github.com/ab-rar-6024/toolright>
+
+Prefer Node directly? `npx toolright ...` or `npm install -g toolright`.
+
+> Pre-release (0.0.1). Model-facing code has not yet been run against live provider APIs. See the main README for the honest status.

toolright-0.0.1/src/toolright.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/toolright/__init__.py
+src/toolright/__main__.py
+src/toolright.egg-info/PKG-INFO
+src/toolright.egg-info/SOURCES.txt
+src/toolright.egg-info/dependency_links.txt
+src/toolright.egg-info/entry_points.txt
+src/toolright.egg-info/top_level.txt
+tests/test_launcher.py

toolright-0.0.1/src/toolright.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

toolright-0.0.1/src/toolright.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+toolright = toolright:main

toolright-0.0.1/src/toolright.egg-info/top_level.txt

@@ -0,0 +1 @@
+toolright

toolright-0.0.1/tests/test_launcher.py

@@ -0,0 +1,55 @@
+import os
+import sys
+import unittest
+from unittest import mock
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+import toolright  # noqa: E402
+
+
+class LauncherTests(unittest.TestCase):
+    def test_version_matches_pyproject(self):
+        here = os.path.dirname(__file__)
+        with open(os.path.join(here, "..", "pyproject.toml"), encoding="utf8") as f:
+            text = f.read()
+        self.assertIn(f'version = "{toolright.__version__}"', text)
+
+    def test_command_pins_the_npm_version_and_passes_args_untouched(self):
+        cmd = toolright.build_command("/x/npx", ["lint", "--", "node", "a b.js", "&calc", "$(x)"])
+        self.assertEqual(cmd[:3], ["/x/npx", "--yes", f"toolright@{toolright.__version__}"])
+        self.assertEqual(cmd[3:], ["lint", "--", "node", "a b.js", "&calc", "$(x)"])
+
+    def test_missing_node_gives_a_clear_message_and_exit_127(self):
+        with mock.patch("shutil.which", return_value=None), mock.patch("sys.stderr") as err:
+            self.assertEqual(toolright.main(["--version"]), 127)
+            self.assertIn("Node.js", "".join(c.args[0] for c in err.write.call_args_list))
+
+    def test_exit_code_is_passed_through(self):
+        with mock.patch("shutil.which", side_effect=lambda n: "/bin/" + n), \
+             mock.patch("subprocess.call", return_value=3) as call:
+            self.assertEqual(toolright.main(["lint"]), 3)
+            args, kwargs = call.call_args
+            self.assertIsInstance(args[0], list)  # never a shell string
+            self.assertNotIn("shell", kwargs)
+
+    def test_refuses_to_recurse(self):
+        with mock.patch.dict(os.environ, {"TOOLRIGHT_PY_LAUNCHER": "1"}), \
+             mock.patch("subprocess.call") as call, mock.patch("sys.stderr"):
+            self.assertEqual(toolright.main(["x"]), 1)
+            call.assert_not_called()
+
+    def test_child_gets_the_guard_variable(self):
+        with mock.patch("shutil.which", side_effect=lambda n: "/bin/" + n), \
+             mock.patch("subprocess.call", return_value=0) as call:
+            toolright.main(["list"])
+            self.assertEqual(call.call_args.kwargs["env"]["TOOLRIGHT_PY_LAUNCHER"], "1")
+
+    def test_ctrl_c_returns_130(self):
+        with mock.patch("shutil.which", side_effect=lambda n: "/bin/" + n), \
+             mock.patch("subprocess.call", side_effect=KeyboardInterrupt):
+            self.assertEqual(toolright.main(["eval"]), 130)
+
+
+if __name__ == "__main__":
+    unittest.main()