toolright 0.0.1__py3-none-any.whl

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/__main__.py

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

toolright-0.0.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+toolright/__init__.py,sha256=aBM5fCiw-u-T5bA2enHRWP3PLjMobKgGMVAmYbBjo7U,1827
+toolright/__main__.py,sha256=BHLi_-4Bx1gsZn-z6x7wECPn1YTxdc74y0deRea9FzY,45
+toolright-0.0.1.dist-info/licenses/LICENSE,sha256=kPTbftroBsh5b6wVBZtwlV7Q1gqE3pRgLO8w72EHD_E,1079
+toolright-0.0.1.dist-info/METADATA,sha256=l6yidd5f2BIgkdxUR2er7r9tvgsYXgU-blmYINd9nks,2099
+toolright-0.0.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+toolright-0.0.1.dist-info/entry_points.txt,sha256=Uw8xl-uoLyKj5DwxXSJRqfty-_ZCbCxK80MZA77p4Lw,45
+toolright-0.0.1.dist-info/top_level.txt,sha256=UIwDO-m9x5vsRHes7HUf4hL2NNl7ukBryrKa4NV5OBM,10
+toolright-0.0.1.dist-info/RECORD,,

toolright-0.0.1.dist-info/WHEEL

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

toolright-0.0.1.dist-info/entry_points.txt

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

toolright-0.0.1.dist-info/licenses/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.dist-info/top_level.txt

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