gret 0.1.0__tar.gz

gret-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.3
+Name: gret
+Version: 0.1.0
+Summary: Golden Retriever - CLI and developer toolkit.
+Author: Yuichi Ito
+Author-email: Yuichi Ito <yuichi@yuichi.com>
+License: Apache-2.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/yuichi110/golden_retriever
+Description-Content-Type: text/markdown
+
+# golden_retriever
+
+Golden Retriever CLI and developer toolkit.
+
+---
+
+## Overview
+
+- **Package Name (PyPI)**: `gret`
+- **Import Module**: `gret`
+- **CLI Command**: `gret`
+- **Developer Management Tool**: `./gcli`
+
+---
+
+## Development Setup
+
+This project uses [uv](https://github.com/astral-sh/uv) for dependency management and packaging.
+
+```bash
+# Sync dependencies and set up virtual environment
+uv sync
+
+# Run the CLI
+uv run gret --help
+
+# Run developer CLI toolsets
+./gcli --help
+./gcli code-check all
+./gcli test all
+```
+
+---
+
+## Developer Toolset (`./gcli`)
+
+The `./gcli` script provides unified developer utilities:
+
+- `./gcli code-check all`: Run Ruff linter and Ty type checker.
+- `./gcli test all`: Run full pytest suite with coverage.
+- `./gcli pypi check-version`: Verify package release version against PyPI.

gret-0.1.0/README.md

@@ -0,0 +1,41 @@
+# golden_retriever
+
+Golden Retriever CLI and developer toolkit.
+
+---
+
+## Overview
+
+- **Package Name (PyPI)**: `gret`
+- **Import Module**: `gret`
+- **CLI Command**: `gret`
+- **Developer Management Tool**: `./gcli`
+
+---
+
+## Development Setup
+
+This project uses [uv](https://github.com/astral-sh/uv) for dependency management and packaging.
+
+```bash
+# Sync dependencies and set up virtual environment
+uv sync
+
+# Run the CLI
+uv run gret --help
+
+# Run developer CLI toolsets
+./gcli --help
+./gcli code-check all
+./gcli test all
+```
+
+---
+
+## Developer Toolset (`./gcli`)
+
+The `./gcli` script provides unified developer utilities:
+
+- `./gcli code-check all`: Run Ruff linter and Ty type checker.
+- `./gcli test all`: Run full pytest suite with coverage.
+- `./gcli pypi check-version`: Verify package release version against PyPI.

gret-0.1.0/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+requires = ["uv-build<0.12"]
+build-backend = "uv_build"
+
+[project]
+name = "gret"
+version = "0.1.0"
+description = "Golden Retriever - CLI and developer toolkit."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Apache-2.0" }
+authors = [{name = "Yuichi Ito", email = "yuichi@yuichi.com"}]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.0.0",
+]
+
+[project.urls]
+Repository = "https://github.com/yuichi110/golden_retriever"
+
+[project.scripts]
+gret = "gret.cli:main"
+
+[tool.uv.build-backend]
+module-name = "gret"
+
+[[tool.uv.index]]
+name = "pypi"
+url = "https://pypi.org/simple"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.9.0",
+    "pytest>=8.3.0",
+    "pytest-cov>=6.0.0",
+    "tomlkit>=0.14.0",
+    "ty>=0.0.35",
+    "typer>=0.12.0",
+    "rich>=13.0.0",
+    "pytest-xdist>=3.8.0",
+]
+
+[tool.ruff]
+preview = false
+fix = true
+unsafe-fixes = false
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    "C90", # mccabe 
+    "F",   # Pyflakes
+    "D",   # pydocstyle
+    "E",   # Pycodestyle Error
+    "I",   # isort
+    "N",   # pep8-naming (N)
+    "W",   # Pycodestyle Warning
+    "ANN", # flake8-annotations (ANN)
+    "CPY", # flake8-copyright
+    "S",   # flake8-bandit
+    "PL"   # Pylint
+]
+
+ignore = [
+    "D203",    # 1 blank line required before class docstring
+    "D212",    # Multi-line docstring summary should start at the first line
+    "D415",    # First line should end with a period, question mark, or exclamation point
+    "F401",    # imported but unused
+    "PLC0414", # Import alias does not rename original package
+    "PLC1901", # compare-to-empty-string
+    "PLR0904", # Too many public methods
+    "PLR0912", # Too many branches
+    "PLR0913", # Too many arguments in function definition
+    "PLR0914", # Too many local variables
+    "PLR0915", # Too many statements
+    "PLR0917", # Too many positional arguments
+    "PLR2004", # Magic value used in comparison
+    "PLW2901"  # Outer variable overwritten by inner target
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tools/**.py" = [
+    "ANN",     # flake8-annotations
+    "S101",    # Use of assert detected
+    "S310",    # Audit URL open for permitted schemes
+    "S404",    # Subprocess module usage
+    "S603",    # Subprocess call without shell=True
+    "S607",    # Subprocess with partial executable path
+    "PLC2701", # Private name import from external module
+    "PLR6301", # Method could be a function/static method
+]
+"tests/**.py" = [
+    "F403", # undefined-local-with-import-star
+    "F405", # undefined-local-with-import-star-usage
+    "D100", # undocumented-public-module
+    "D101", # undocumented-public-class
+    "D102", # undocumented-public-method
+    "D103", # undocumented-public-function
+    "D104", # undocumented-public-package
+    "D107", # undocumented-public-init
+    "ANN",  # flake8-annotations
+    "CPY",  # flake8-copyright
+    "S101", # Use of assert detected
+    "PLC2701", # Private name import from external module (standard for unit tests)
+    "PLR6301" # Method could be a function/static method (standard for pytest classes)
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

gret-0.1.0/src/gret/__init__.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2026 Yuichi Ito (yuichi@yuichi.com)
+#
+# This software is licensed under the Apache License, Version 2.0.
+# For more information, please visit: https://github.com/yuichi110/golden_retriever
+#
+# This 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.
+
+"""Golden Retriever - CLI and developer toolkit."""
+
+from __future__ import annotations
+
+from typing import Final
+
+LIB_NAME: Final[str] = "gret"
+LIB_VERSION: Final[str] = "0.1.0"
+
+__version__: Final[str] = LIB_VERSION
+
+__all__ = [
+    "LIB_NAME",
+    "LIB_VERSION",
+    "__version__",
+]

gret-0.1.0/src/gret/cli.py

@@ -0,0 +1,53 @@
+# Copyright (c) 2026 Yuichi Ito (yuichi@yuichi.com)
+#
+# This software is licensed under the Apache License, Version 2.0.
+# For more information, please visit: https://github.com/yuichi110/golden_retriever
+#
+# This 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.
+
+"""Command line interface for Golden Retriever (gret)."""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+from gret import LIB_NAME, LIB_VERSION
+
+app = typer.Typer(
+    name="gret",
+    help="Golden Retriever CLI application.",
+    no_args_is_help=False,
+)
+
+console = Console()
+
+
+@app.command("version")
+def version() -> None:
+    """Display version information."""
+    console.print(f"[bold cyan]{LIB_NAME}[/bold cyan] version [bold green]{LIB_VERSION}[/bold green]")
+
+
+@app.callback(invoke_without_command=True)
+def callback(ctx: typer.Context) -> None:
+    """Golden Retriever entrypoint callback.
+
+    Args:
+        ctx: Typer context object.
+    """
+    if ctx.invoked_subcommand is None:
+        console.print("[bold cyan]Golden Retriever CLI[/bold cyan]")
+        console.print(f"{LIB_NAME} version [bold green]{LIB_VERSION}[/bold green]\n")
+        console.print("Run [bold]gret --help[/bold] for available commands.")
+
+
+def main() -> None:
+    """Execute gret CLI."""
+    app()
+
+
+if __name__ == "__main__":
+    main()

gret-0.1.0/src/gret/py.typed

@@ -0,0 +1 @@
+# Marker file for PEP 561