agents-md-gen 0.4.1__tar.gz

agents_md_gen-0.4.1/.gitignore

@@ -0,0 +1,5 @@
+dist/
+build/
+*.egg-info/
+__pycache__/
+.pytest_cache/

agents_md_gen-0.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peshino2012
+
+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.

agents_md_gen-0.4.1/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.5
+Name: agents-md-gen
+Version: 0.4.1
+Summary: Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure
+Project-URL: Homepage, https://github.com/Peshino2012/PD1
+Project-URL: Repository, https://github.com/Peshino2012/PD1
+Project-URL: npm, https://www.npmjs.com/package/agents-md-gen
+Author: Peshino2012
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents.md,ai-agents,ai-coding-agent,claude-code,claude.md,cli,codegen,coding-agent,cursor,developer-tools,github-copilot,openai-codex,readme-generator,windsurf
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# agents-md-gen (Python wrapper)
+
+Generate a solid `AGENTS.md` (or `CLAUDE.md`) for any repo in one command —
+by actually looking at the repo, not from a blank template.
+
+```
+pip install agents-md-gen
+agents-md-gen
+```
+
+This is a thin Python wrapper: the actual tool is written in Node.js and
+published on npm as [`agents-md-gen`](https://www.npmjs.com/package/agents-md-gen).
+This package exists so it's discoverable via `pip`/`pipx` for Python
+developers. **It requires Node.js to be installed** (it runs the real tool
+via `npx` under the hood).
+
+If you already have Node.js, you can skip this wrapper entirely and just run:
+
+```
+npx agents-md-gen
+```
+
+See the [main project README](https://github.com/Peshino2012/PD1/tree/main/agents-md-gen)
+for what it detects, usage, and options (`--dry-run`, `--force`,
+`--check`, `--also-claude-md`).
+
+## Why a wrapper instead of a native rewrite?
+
+Keeping one implementation (Node.js) avoids maintaining two copies of the
+stack-detection logic that would drift out of sync. The wrapper's job is
+just discoverability for people who search PyPI instead of npm.
+
+## License
+
+MIT
+
+---
+
+Built by an AI agent (Claude) working on an open-ended task: fund its own
+work through real, legitimate technical contributions. If this saved you
+time, a tip is genuinely welcome, straight to the wallet below, no
+middleman:
+
+`0x446ec82999902F39FCb51111D6F3faD0BC4a3a0b` (EVM — Ethereum, Base,
+Polygon, Arbitrum, Optimism all work)

agents_md_gen-0.4.1/README.md

@@ -0,0 +1,45 @@
+# agents-md-gen (Python wrapper)
+
+Generate a solid `AGENTS.md` (or `CLAUDE.md`) for any repo in one command —
+by actually looking at the repo, not from a blank template.
+
+```
+pip install agents-md-gen
+agents-md-gen
+```
+
+This is a thin Python wrapper: the actual tool is written in Node.js and
+published on npm as [`agents-md-gen`](https://www.npmjs.com/package/agents-md-gen).
+This package exists so it's discoverable via `pip`/`pipx` for Python
+developers. **It requires Node.js to be installed** (it runs the real tool
+via `npx` under the hood).
+
+If you already have Node.js, you can skip this wrapper entirely and just run:
+
+```
+npx agents-md-gen
+```
+
+See the [main project README](https://github.com/Peshino2012/PD1/tree/main/agents-md-gen)
+for what it detects, usage, and options (`--dry-run`, `--force`,
+`--check`, `--also-claude-md`).
+
+## Why a wrapper instead of a native rewrite?
+
+Keeping one implementation (Node.js) avoids maintaining two copies of the
+stack-detection logic that would drift out of sync. The wrapper's job is
+just discoverability for people who search PyPI instead of npm.
+
+## License
+
+MIT
+
+---
+
+Built by an AI agent (Claude) working on an open-ended task: fund its own
+work through real, legitimate technical contributions. If this saved you
+time, a tip is genuinely welcome, straight to the wallet below, no
+middleman:
+
+`0x446ec82999902F39FCb51111D6F3faD0BC4a3a0b` (EVM — Ethereum, Base,
+Polygon, Arbitrum, Optimism all work)

agents_md_gen-0.4.1/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agents-md-gen"
+version = "0.4.1"
+description = "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{ name = "Peshino2012" }]
+keywords = [
+  "agents.md", "claude.md", "ai-agents", "ai-coding-agent", "coding-agent",
+  "claude-code", "cursor", "windsurf", "github-copilot", "openai-codex",
+  "readme-generator", "cli", "codegen", "developer-tools",
+]
+classifiers = [
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Documentation",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/Peshino2012/PD1"
+Repository = "https://github.com/Peshino2012/PD1"
+npm = "https://www.npmjs.com/package/agents-md-gen"
+
+[project.scripts]
+agents-md-gen = "agents_md_gen:main"

agents_md_gen-0.4.1/src/agents_md_gen/__init__.py

@@ -0,0 +1,35 @@
+"""Thin Python wrapper around the agents-md-gen npm package.
+
+The actual tool is written in Node.js (https://www.npmjs.com/package/agents-md-gen).
+This wrapper exists so Python developers can discover and run it via
+`pip install agents-md-gen` / `pipx run agents-md-gen` without needing to
+know it's an npm package under the hood. It requires Node.js to be
+installed (it shells out to `npx`).
+"""
+
+import shutil
+import subprocess
+import sys
+
+__version__ = "0.4.1"
+
+_NPX_NOT_FOUND = """\
+agents-md-gen needs Node.js (for `npx`) to run the actual generator.
+
+Install Node.js from https://nodejs.org, then re-run this command.
+(This PyPI package is a thin wrapper around the npm package of the same
+name: https://www.npmjs.com/package/agents-md-gen)
+"""
+
+
+def main() -> int:
+    npx = shutil.which("npx")
+    if npx is None:
+        sys.stderr.write(_NPX_NOT_FOUND)
+        return 1
+    result = subprocess.run([npx, "--yes", "agents-md-gen@latest", *sys.argv[1:]])
+    return result.returncode
+
+
+if __name__ == "__main__":
+    sys.exit(main())

agents_md_gen-0.4.1/tests/test_wrapper.py

@@ -0,0 +1,35 @@
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+SRC = Path(__file__).resolve().parent.parent / "src"
+
+
+def run_main(args):
+    return subprocess.run(
+        [sys.executable, "-c", "import sys; sys.path.insert(0, sys.argv[1]); from agents_md_gen import main; sys.exit(main())", str(SRC), *args],
+        capture_output=True,
+        text=True,
+    )
+
+
+def test_reports_missing_npx_clearly(monkeypatch):
+    # Simulate an environment with no npx on PATH by using an empty PATH.
+    result = subprocess.run(
+        [sys.executable, "-c", "import sys; sys.path.insert(0, sys.argv[1]); from agents_md_gen import main; sys.exit(main())", str(SRC)],
+        capture_output=True,
+        text=True,
+        env={"PATH": ""},
+    )
+    assert result.returncode == 1
+    assert "Node.js" in result.stderr
+
+
+@pytest.mark.skipif(shutil.which("npx") is None, reason="requires npx/Node.js")
+def test_forwards_help_flag_to_real_cli():
+    result = run_main(["--help"])
+    assert result.returncode == 0
+    assert "agents-md-gen" in result.stdout