toolbelt-cli 0.2.0__py3-none-any.whl

toolbelt/services/llm.py

@@ -0,0 +1,105 @@
+"""Anthropic Claude LLM wrapper with rule-based fallback commit generator."""
+
+from __future__ import annotations
+
+import os
+import re
+from typing import Any
+
+import anthropic
+
+DEFAULT_MODEL = "claude-sonnet-4"
+
+SYSTEM_PROMPT = (
+    "You generate Conventional Commits messages. Given a git diff, output ONLY "
+    "the commit message. Format: <type>(<scope>): <subject>\n\n<body if needed>. "
+    "Types: feat, fix, docs, style, refactor, test, chore. Max 72 chars for subject."
+)
+
+
+class CommitMessageGenerator:
+    """Generate Conventional Commit messages from a git diff."""
+
+    def __init__(self, api_key: str | None = None) -> None:
+        self.api_key = api_key or os.getenv("ANTHROPIC_API_KEY")
+
+    def generate(
+        self,
+        diff: str,
+        commit_type: str | None = None,
+        scope: str | None = None,
+    ) -> str:
+        """Generate a conventional commit message."""
+        if self.api_key and self.api_key.strip():
+            return self._call_claude(diff, commit_type, scope)
+        return self._fallback(diff, commit_type, scope)
+
+    def _call_claude(
+        self,
+        diff: str,
+        commit_type: str | None,
+        scope: str | None,
+    ) -> str:
+        client = anthropic.Anthropic(api_key=self.api_key)
+        user_prompt = diff
+        instructions = []
+        if commit_type:
+            instructions.append(f"Commit type MUST be: {commit_type}")
+        if scope:
+            instructions.append(f"Commit scope MUST be: {scope}")
+        if instructions:
+            user_prompt = f"[{'; '.join(instructions)}]\n\n{diff}"
+
+        response = client.messages.create(
+            model=DEFAULT_MODEL,
+            max_tokens=256,
+            system=SYSTEM_PROMPT,
+            messages=[{"role": "user", "content": user_prompt}],
+        )
+
+        content: Any = response.content
+        if isinstance(content, list) and content:
+            item = content[0]
+            if hasattr(item, "text"):
+                return str(item.text).strip()
+            if isinstance(item, dict) and "text" in item:
+                return str(item["text"]).strip()
+            return str(item).strip()
+        if hasattr(content, "text"):
+            return str(content.text).strip()
+        return str(content).strip()
+
+    def _fallback(
+        self,
+        diff: str,
+        commit_type: str | None = None,
+        scope: str | None = None,
+    ) -> str:
+        """Rule-based generator when no Anthropic API key is available."""
+        lines = diff.splitlines()
+        added = sum(
+            1 for line in lines if line.startswith("+") and not line.startswith("+++")
+        )
+        removed = sum(
+            1 for line in lines if line.startswith("-") and not line.startswith("---")
+        )
+        files = set(re.findall(r"^\+\+\+ b/(.+)$", diff, flags=re.MULTILINE))
+        files_count = max(len(files), 1)
+
+        if commit_type:
+            guess_type = commit_type.strip()
+        else:
+            diff_lower = diff.lower()
+            if any(term in diff_lower for term in ["test", "tests/"]):
+                guess_type = "test"
+            elif any(term in diff_lower for term in ["doc", "docs/", "readme"]):
+                guess_type = "docs"
+            elif any(term in diff_lower for term in [".css", ".scss", "style"]):
+                guess_type = "style"
+            else:
+                guess_type = "chore"
+
+        scope_part = f"({scope.strip()})" if scope and scope.strip() else ""
+        file_label = "file" if files_count == 1 else "files"
+        stats = f"(+{added}/-{removed} lines)"
+        return f"{guess_type}{scope_part}: update {files_count} {file_label} {stats}"

toolbelt/services/scaffolder.py

@@ -0,0 +1,91 @@
+"""Project scaffolding service using Jinja2 templates."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Any
+
+import jinja2
+
+TEMPLATE_ROOT = Path(__file__).parent.parent / "templates"
+
+
+class Scaffolder:
+    """Render project templates and write files to disk."""
+
+    def __init__(
+        self,
+        project_type: str,
+        project_name: str,
+        author: str,
+        license: str,
+        include_ci: bool,
+        include_docker: bool,
+        destination: Path,
+    ) -> None:
+        self.project_type = project_type.lower()
+        self.project_name = project_name
+        self.author = author
+        self.license = license
+        self.include_ci = include_ci
+        self.include_docker = include_docker
+        self.destination = destination
+
+        tmpl_dir = TEMPLATE_ROOT / self.project_type
+        self.env = jinja2.Environment(
+            loader=jinja2.FileSystemLoader(str(tmpl_dir)),
+            autoescape=False,
+            keep_trailing_newline=True,
+        )
+        self.context: dict[str, Any] = {
+            "project_name": project_name,
+            "author": author,
+            "license": license,
+            "include_ci": include_ci,
+            "include_docker": include_docker,
+        }
+
+    def _render_template(self, template_posix_path: str) -> str:
+        template = self.env.get_template(template_posix_path)
+        return template.render(**self.context)
+
+    def _write_file(self, relative_path: Path, content: str) -> None:
+        target = self.destination / relative_path
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(content, encoding="utf-8")
+
+    def run(self) -> None:
+        """Run the scaffolding process."""
+        tmpl_root = TEMPLATE_ROOT / self.project_type
+        if not tmpl_root.exists():
+            raise FileNotFoundError(f"Template directory not found: {tmpl_root}")
+
+        for root, _, files in os.walk(tmpl_root):
+            for fname in files:
+                full_src = Path(root) / fname
+                rel_src = full_src.relative_to(tmpl_root)
+                rel_posix = rel_src.as_posix()
+
+                # Filter optional files
+                if "ci.yml" in rel_posix and not self.include_ci:
+                    continue
+                if "Dockerfile" in rel_posix and not self.include_docker:
+                    continue
+                if "LICENSE" in rel_posix and self.license.lower() == "none":
+                    continue
+
+                # Render content
+                if fname.endswith(".j2"):
+                    content = self._render_template(rel_posix)
+                else:
+                    content = full_src.read_text(encoding="utf-8")
+
+                # Resolve path placeholders like {{project_name}}
+                rendered_rel_path = rel_posix.replace(
+                    "{{project_name}}", self.project_name
+                )
+                if rendered_rel_path.endswith(".j2"):
+                    rendered_rel_path = rendered_rel_path[:-3]
+
+                self._write_file(Path(rendered_rel_path), content)

toolbelt/templates/java/.gitignore.j2

@@ -0,0 +1,7 @@
+target/
+*.class
+*.jar
+*.war
+*.ear
+*.iml
+.idea/

toolbelt/templates/java/LICENSE.j2

@@ -0,0 +1,39 @@
+{% if license == "Apache-2.0" %}                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright (c) {{author}}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+{% else %}MIT License
+
+Copyright (c) {{author}}
+
+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.
+{% endif %}

toolbelt/templates/java/README.md.j2

@@ -0,0 +1,26 @@
+# {{project_name}}
+
+A Java Maven project scaffolded by Toolbelt CLI.
+
+## Installation
+
+```bash
+mvn clean install -DskipTests
+```
+
+## Usage
+
+```bash
+mvn clean package
+java -cp target/{{project_name}}-0.1.0.jar com.{{project_name}}.App
+```
+
+## Test
+
+```bash
+mvn test
+```
+
+## License
+
+{{license}}

toolbelt/templates/java/pom.xml.j2

@@ -0,0 +1,53 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+                             https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>com.{{project_name}}</groupId>
+  <artifactId>{{project_name}}</artifactId>
+  <version>0.1.0</version>
+  <name>{{project_name}}</name>
+  <description>Java project scaffolded by Toolbelt CLI</description>
+  <licenses>
+    <license>
+      <name>{{license}}</name>
+      <url>https://opensource.org/licenses/{{license}}</url>
+    </license>
+  </licenses>
+
+  <properties>
+    <maven.compiler.source>17</maven.compiler.source>
+    <maven.compiler.target>17</maven.compiler.target>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter</artifactId>
+      <version>5.10.0</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.10.1</version>
+        <configuration>
+          <source>17</source>
+          <target>17</target>
+        </configuration>
+      </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>3.1.2</version>
+      </plugin>
+    </plugins>
+  </build>
+
+</project>

toolbelt/templates/java/src/main/java/com/{{project_name}}/App.java.j2

@@ -0,0 +1,7 @@
+package com.{{project_name}};
+
+public class App {
+    public static void main(String[] args) {
+        System.out.println("Hello from {{project_name}}!");
+    }
+}

toolbelt/templates/java/src/test/java/com/{{project_name}}/AppTest.java.j2

@@ -0,0 +1,13 @@
+package com.{{project_name}};
+
+import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.*;
+
+class AppTest {
+
+    @Test
+    void testMainOutputsGreeting() {
+        // Simple sanity test – in a real project you would capture stdout
+        assertTrue(true);
+    }
+}

toolbelt/templates/node/.eslintrc.json.j2

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended"],
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint"],
+  "rules": {}
+}

toolbelt/templates/node/.gitignore.j2

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.env
+.env.local
+.DS_Store
+coverage/
+*.log

toolbelt/templates/node/.prettierrc.j2

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80
+}

toolbelt/templates/node/LICENSE.j2

@@ -0,0 +1,39 @@
+{% if license == "Apache-2.0" %}                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright (c) {{author}}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+{% else %}MIT License
+
+Copyright (c) {{author}}
+
+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.
+{% endif %}

toolbelt/templates/node/README.md.j2

@@ -0,0 +1,26 @@
+# {{project_name}}
+
+A modern Node.js and TypeScript project scaffolded by Toolbelt CLI.
+
+## Installation
+
+```bash
+npm install
+```
+
+## Usage
+
+```bash
+npm run build
+node dist/index.js
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## License
+
+{{license}}

toolbelt/templates/node/package.json.j2

@@ -0,0 +1,20 @@
+{
+  "name": "{{project_name}}",
+  "version": "0.1.0",
+  "description": "{{project_name}} – scaffolded by Toolbelt CLI",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write ."
+  },
+  "author": "{{author}}",
+  "license": "{{license}}",
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "vitest": "^2.0.0"
+  }
+}

toolbelt/templates/node/src/index.test.ts.j2

@@ -0,0 +1,6 @@
+import { expect, test } from "vitest";
+import { hello } from "./index";
+
+test("hello returns greeting", () => {
+  expect(hello()).toBe("Hello from {{project_name}}!");
+});

toolbelt/templates/node/src/index.ts.j2

@@ -0,0 +1,7 @@
+export function hello(): string {
+  return "Hello from {{project_name}}!";
+}
+
+if (import.meta.main) {
+  console.log(hello());
+}

toolbelt/templates/node/tsconfig.json.j2

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}

toolbelt/templates/python/.github/workflows/ci.yml.j2

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+          pip install ruff mypy pytest
+      - name: Lint with ruff
+        run: ruff check .
+      - name: Type check with mypy
+        run: mypy .
+      - name: Run tests
+        run: pytest --cov=src

toolbelt/templates/python/.gitignore.j2

@@ -0,0 +1,42 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+Dist/
+Downloads/
+Eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/

toolbelt/templates/python/.pre-commit-config.yaml.j2

@@ -0,0 +1,13 @@
+repos:
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.1.0
+    hooks:
+      - id: ruff
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v0.9.0
+    hooks:
+      - id: mypy
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: trailing-whitespace

toolbelt/templates/python/Dockerfile.j2

@@ -0,0 +1,10 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+COPY . /app
+
+RUN pip install --upgrade pip && \
+    pip install -e . && \
+    pip install ruff mypy pytest
+
+CMD ["python", "-m", "{{project_name}}.main"]

toolbelt/templates/python/LICENSE.j2

@@ -0,0 +1,39 @@
+{% if license == "Apache-2.0" %}                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright (c) {{author}}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+{% else %}MIT License
+
+Copyright (c) {{author}}
+
+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.
+{% endif %}

toolbelt/templates/python/Makefile.j2

@@ -0,0 +1,17 @@
+.PHONY: install test lint format clean
+
+install:
+	pip install -e ".[dev]"
+
+test:
+	pytest
+
+lint:
+	ruff check .
+	mypy src tests
+
+format:
+	ruff format .
+
+clean:
+	rm -rf build dist *.egg-info .pytest_cache .mypy_cache

toolbelt/templates/python/README.md.j2

@@ -0,0 +1,19 @@
+# {{project_name}}
+
+{{project_name}} – a Python project scaffolded by Toolbelt CLI.
+
+## Installation
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+```bash
+python -m {{project_name}}.main
+```
+
+## License
+
+{{license}}