frob 0.0.0__tar.gz

frob-0.0.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: frob
+Version: 0.0.0
+Summary: These are tools that I use in my development workflow.
+Author-email: Logan Dapp <logan@logand.app>
+License: MIT
+Project-URL: Homepage, https://github.com/lognd/frob
+Project-URL: Documentation, https://github.com/lognd/frob/docs
+Project-URL: Source, https://github.com/lognd/frob
+Project-URL: Issues, https://github.com/lognd/frob/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: typani>=0.0.3
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: tree-sitter>=0.25.2
+Requires-Dist: tree-sitter-python>=0.25.0
+Requires-Dist: tree-sitter-cpp>=0.23.4
+Requires-Dist: jinja2>=3.1
+
+# frob
+
+Developer workflow CLI tools. Designed for agentic and human use.
+
+Install: `pip install frob` or `uvx frob`. For editable dev install: `pip install -e .`
+
+---
+
+## Commands
+
+### `frob init` -- project scaffolding
+
+```bash
+frob init list                              # list registered project types
+frob init new <type> <name> --output DIR   # scaffold a new project
+```
+
+Project types:
+- `python-library` -- installable Python package with logging, tests, CI
+- `python-tool` -- Python CLI tool with argparse, app/, config, CI
+- `cpp-library` -- FetchContent-compatible C++ library with CMake, GTest/Catch2, CI
+- `cpp-tool` -- C++ executable with CMake, cross-platform CI, release workflow
+- `pybind11-library` -- hybrid Python/C++ library using pybind11 + scikit-build-core
+- `pyo3-library` -- hybrid Python/Rust library using PyO3 + maturin
+
+All templates include: Makefile, .gitignore, docs/, GitHub Actions CI, branch-protection workflow.
+
+---
+
+### `frob map` -- project structure
+
+```bash
+frob map src/           # directory tree with token counts per file
+frob map src/ --json    # JSON with path, lines, tokens, symbols per file
+frob map src/ --depth 2 # limit recursion depth
+```
+
+---
+
+### `frob outline` -- file signatures
+
+```bash
+frob outline src/file.py           # functions and classes with line numbers
+frob outline src/file.py --json    # structured JSON output
+```
+
+Shows signatures only -- no bodies. Fast way to see what is in a file before reading it.
+
+---
+
+### `frob stub` -- single-function context
+
+```bash
+frob stub src/file.py target_fn              # keep target intact, stub everything else
+frob stub src/file.py MyClass.method         # class method variant
+frob stub src/file.py target_fn --output FILE
+```
+
+Useful for giving an LLM minimal context for one function.
+
+---
+
+### `frob bundle` -- function + its dependencies
+
+```bash
+frob bundle src/file.py fn_name         # function + all functions it calls
+frob bundle src/file.py fn_name --depth 2
+frob bundle src/file.py fn_name --format json
+```
+
+---
+
+### `frob tokens` -- token count
+
+```bash
+frob tokens src/file.py            # total tokens
+frob tokens src/file.py --detail   # per-symbol breakdown
+frob tokens src/ --json            # JSON with total_tokens and per-file list
+```
+
+---
+
+### `frob xref` -- cross-references
+
+```bash
+frob xref symbol src/       # find definition + all callers of a symbol
+frob xref symbol src/ --json
+```
+
+---
+
+### `frob cycle` -- import cycle detection
+
+```bash
+frob cycle src/             # detect import cycles
+frob cycle src/ --suggest   # with refactoring suggestions
+```
+
+---
+
+### `frob dup` -- duplicate code detection
+
+```bash
+frob dup src/                       # find structurally identical code blocks
+frob dup src/ --min-lines 10        # minimum block size
+frob dup src/ --json                # JSON with groups, clone_type, fragments
+```
+
+Detects exact clones and renamed-variable clones.
+
+---
+
+### `frob arch` -- architectural lint
+
+```bash
+frob arch src/                              # god-class, long-function, deep-nesting
+frob arch src/ --json                       # JSON with suggestions list
+frob arch src/ --max-function-lines 50
+frob arch src/ --max-class-methods 20
+```
+
+---
+
+### `frob docs` -- docstrings and docs/ search
+
+```bash
+frob docs src/file.py                       # extract all docstrings
+frob docs src/file.py MyClass               # docstrings for a specific symbol
+frob docs src/file.py --overview            # relevant headings from docs/ folder
+frob docs src/ --search "authentication"    # full-text search through docs/ .md files
+frob docs src/file.py --json
+```
+
+---
+
+### `frob bind` -- binding consistency check
+
+```bash
+frob bind .                    # verify // BIND: comments match source declarations
+frob bind . --json             # JSON with ok, mismatches list
+frob bind . --list-bindings    # show all BIND declarations found
+frob bind . --list-sources     # show all detected source signatures
+```
+
+Checks pybind11 (`bindings.cpp`) and PyO3 (`lib.rs`) `// BIND: signature` comments
+against actual C++ header declarations and Rust `#[pyfunction]` signatures.
+
+---
+
+### `frob parse` -- parse tool output
+
+```bash
+<tool> | frob parse <tool>          # parse and summarize
+<tool> | frob parse <tool> --json   # structured JSON
+<tool> | frob parse <tool> --passthrough   # propagate exit code
+```
+
+Supported tools: `pytest`, `ruff`, `ty`, `clang`, `junit`, `pycharm`
+
+---
+
+### `frob inspect` -- PyCharm headless inspection
+
+```bash
+frob inspect <project_dir>
+frob inspect <project_dir> --json
+```
+
+---
+
+## Development
+
+```bash
+make install      # uv sync --all-extras
+make format       # black + ruff format
+make lint         # ruff + ty check
+make test         # pytest tests/
+make test-fast    # pytest --testmon (incremental)
+make upload       # bump version if needed, build wheel, publish to PyPI
+make clean
+```
+
+The `.frob-foundation.md` convention: when `smart-start` generates infrastructure code,
+it writes a registry of abstractions to `.frob-foundation.md` at the project root.
+The `implementer` agent reads this file automatically so it knows which base classes,
+protocols, and helpers already exist and should be used.

frob-0.0.0/README.md

@@ -0,0 +1,186 @@
+# frob
+
+Developer workflow CLI tools. Designed for agentic and human use.
+
+Install: `pip install frob` or `uvx frob`. For editable dev install: `pip install -e .`
+
+---
+
+## Commands
+
+### `frob init` -- project scaffolding
+
+```bash
+frob init list                              # list registered project types
+frob init new <type> <name> --output DIR   # scaffold a new project
+```
+
+Project types:
+- `python-library` -- installable Python package with logging, tests, CI
+- `python-tool` -- Python CLI tool with argparse, app/, config, CI
+- `cpp-library` -- FetchContent-compatible C++ library with CMake, GTest/Catch2, CI
+- `cpp-tool` -- C++ executable with CMake, cross-platform CI, release workflow
+- `pybind11-library` -- hybrid Python/C++ library using pybind11 + scikit-build-core
+- `pyo3-library` -- hybrid Python/Rust library using PyO3 + maturin
+
+All templates include: Makefile, .gitignore, docs/, GitHub Actions CI, branch-protection workflow.
+
+---
+
+### `frob map` -- project structure
+
+```bash
+frob map src/           # directory tree with token counts per file
+frob map src/ --json    # JSON with path, lines, tokens, symbols per file
+frob map src/ --depth 2 # limit recursion depth
+```
+
+---
+
+### `frob outline` -- file signatures
+
+```bash
+frob outline src/file.py           # functions and classes with line numbers
+frob outline src/file.py --json    # structured JSON output
+```
+
+Shows signatures only -- no bodies. Fast way to see what is in a file before reading it.
+
+---
+
+### `frob stub` -- single-function context
+
+```bash
+frob stub src/file.py target_fn              # keep target intact, stub everything else
+frob stub src/file.py MyClass.method         # class method variant
+frob stub src/file.py target_fn --output FILE
+```
+
+Useful for giving an LLM minimal context for one function.
+
+---
+
+### `frob bundle` -- function + its dependencies
+
+```bash
+frob bundle src/file.py fn_name         # function + all functions it calls
+frob bundle src/file.py fn_name --depth 2
+frob bundle src/file.py fn_name --format json
+```
+
+---
+
+### `frob tokens` -- token count
+
+```bash
+frob tokens src/file.py            # total tokens
+frob tokens src/file.py --detail   # per-symbol breakdown
+frob tokens src/ --json            # JSON with total_tokens and per-file list
+```
+
+---
+
+### `frob xref` -- cross-references
+
+```bash
+frob xref symbol src/       # find definition + all callers of a symbol
+frob xref symbol src/ --json
+```
+
+---
+
+### `frob cycle` -- import cycle detection
+
+```bash
+frob cycle src/             # detect import cycles
+frob cycle src/ --suggest   # with refactoring suggestions
+```
+
+---
+
+### `frob dup` -- duplicate code detection
+
+```bash
+frob dup src/                       # find structurally identical code blocks
+frob dup src/ --min-lines 10        # minimum block size
+frob dup src/ --json                # JSON with groups, clone_type, fragments
+```
+
+Detects exact clones and renamed-variable clones.
+
+---
+
+### `frob arch` -- architectural lint
+
+```bash
+frob arch src/                              # god-class, long-function, deep-nesting
+frob arch src/ --json                       # JSON with suggestions list
+frob arch src/ --max-function-lines 50
+frob arch src/ --max-class-methods 20
+```
+
+---
+
+### `frob docs` -- docstrings and docs/ search
+
+```bash
+frob docs src/file.py                       # extract all docstrings
+frob docs src/file.py MyClass               # docstrings for a specific symbol
+frob docs src/file.py --overview            # relevant headings from docs/ folder
+frob docs src/ --search "authentication"    # full-text search through docs/ .md files
+frob docs src/file.py --json
+```
+
+---
+
+### `frob bind` -- binding consistency check
+
+```bash
+frob bind .                    # verify // BIND: comments match source declarations
+frob bind . --json             # JSON with ok, mismatches list
+frob bind . --list-bindings    # show all BIND declarations found
+frob bind . --list-sources     # show all detected source signatures
+```
+
+Checks pybind11 (`bindings.cpp`) and PyO3 (`lib.rs`) `// BIND: signature` comments
+against actual C++ header declarations and Rust `#[pyfunction]` signatures.
+
+---
+
+### `frob parse` -- parse tool output
+
+```bash
+<tool> | frob parse <tool>          # parse and summarize
+<tool> | frob parse <tool> --json   # structured JSON
+<tool> | frob parse <tool> --passthrough   # propagate exit code
+```
+
+Supported tools: `pytest`, `ruff`, `ty`, `clang`, `junit`, `pycharm`
+
+---
+
+### `frob inspect` -- PyCharm headless inspection
+
+```bash
+frob inspect <project_dir>
+frob inspect <project_dir> --json
+```
+
+---
+
+## Development
+
+```bash
+make install      # uv sync --all-extras
+make format       # black + ruff format
+make lint         # ruff + ty check
+make test         # pytest tests/
+make test-fast    # pytest --testmon (incremental)
+make upload       # bump version if needed, build wheel, publish to PyPI
+make clean
+```
+
+The `.frob-foundation.md` convention: when `smart-start` generates infrastructure code,
+it writes a registry of abstractions to `.frob-foundation.md` at the project root.
+The `implementer` agent reads this file automatically so it knows which base classes,
+protocols, and helpers already exist and should be used.

frob-0.0.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "frob"
+version = "0.0.0"
+description = "These are tools that I use in my development workflow."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Logan Dapp", email = "logan@logand.app" }
+]
+
+dependencies = [
+    "tomli>=2.0; python_version < '3.11'",
+    "typani>=0.0.3",
+    "pydantic>=2.12.0",
+    "tree-sitter>=0.25.2",
+    "tree-sitter-python>=0.25.0",
+    "tree-sitter-cpp>=0.23.4",
+    "jinja2>=3.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/lognd/frob"
+Documentation = "https://github.com/lognd/frob/docs"
+Source = "https://github.com/lognd/frob"
+Issues = "https://github.com/lognd/frob/issues"
+
+[dependency-groups]
+dev = [
+    "black>=24",
+    "packaging",
+    "pytest>=8",
+    "pytest-testmon>=2",
+    "ruff>=0.8",
+    "ty>=0.0.1a8",
+]
+
+[tool.setuptools]
+packages = { find = { where = ["src"] } }
+
+[tool.setuptools.package-data]
+frob = ["py.typed", "init/data/*.j2", "logging/config.toml"]
+
+[tool.ruff]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["E501"]
+# Fixture files are intentionally bad code used to test error detection
+"tests/fixtures/**" = ["E501", "F401", "F811", "F841", "E741", "W"]
+
+[tool.black]
+line-length = 88
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+pythonpath = ["."]

frob-0.0.0/setup.cfg

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