wtg-cli 0.1.0__cp313-cp313-win_amd64.whl

wtg_cli/__init__.py

@@ -0,0 +1,14 @@
+"""Python helpers for the What The Git CLI package."""
+
+from importlib import metadata as _metadata
+
+from .cli import main, run
+
+try:
+    __version__ = _metadata.version("wtg-cli")
+except (
+    _metadata.PackageNotFoundError
+):  # pragma: no cover - fallback for editable installs
+    __version__ = "0.0.0"
+
+__all__ = ["main", "run", "__version__"]

wtg_cli/__main__.py

@@ -0,0 +1,7 @@
+"""Allow running ``python -m wtg_cli``."""
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

wtg_cli/cli.py

@@ -0,0 +1,35 @@
+"""Wrapper functions that route Python entry points to the Rust CLI."""
+
+from __future__ import annotations
+
+import sys
+from typing import Iterable, Sequence
+
+from . import _wtg
+
+
+def run(argv: Iterable[str] | None = None) -> int:
+    """Execute the CLI using the provided argv sequence.
+
+    When *argv* is ``None`` the current ``sys.argv`` is forwarded, which mirrors
+    invoking the tool as a standalone executable.
+    """
+
+    args: list[str]
+    if argv is None:
+        args = list(sys.argv)
+    elif isinstance(argv, Sequence):
+        args = list(argv)
+    else:
+        args = list(argv)
+
+    if not args:
+        args = ["wtg"]
+
+    return _wtg.run_cli([str(arg) for arg in args])
+
+
+def main() -> int:
+    """Entry point used by ``python -m wtg_cli`` and console scripts."""
+
+    return run()

wtg_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: wtg-cli
+Version: 0.1.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Version Control :: Git
+License-File: LICENSE
+Summary: What The Git CLI – snarky Git history sleuth packaged for Python
+Author: Mike Perlov
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# What The Git (wtg) 🔍
+
+A snarky but helpful CLI tool to identify git commits, issues, PRs and file changes, and tell you which release they shipped in. Because sometimes you just need to know what the git is going on!
+
+A totally vibe-coded tool, so do not blame me if it hurts your feelings. 😄
+
+## Features
+
+- 🔍 **Smart Detection**: Automatically identifies what you're looking for (commit hash, issue/PR number, file path, or tag)
+- 🌐 **Remote Repository Support**: Work with any GitHub repository without cloning it locally
+- 🔗 **GitHub URL Parsing**: Paste any GitHub URL (commit, issue, PR, file) and wtg figures it out
+- 🎨 **Colorful Output**: Beautiful terminal output with emojis and colors
+- 😄 **Snarky Messages**: Helpful error messages with personality
+- 📦 **Release Tracking**: Finds which release first shipped your commit
+- 👤 **Blame Info**: Shows who's responsible for that pesky bug
+- 🚀 **Smart Caching**: Efficiently caches remote repositories with minimal disk usage
+- 🌐 **Graceful Degradation**: Works without network or GitHub remote
+
+## Installation
+
+### Recommended: Python package
+
+Run the (python) CLI without installing anything permanently:
+
+```bash
+uvx --from wtg-cli wtg --help
+```
+
+Or install it as a global tool (works on macOS, Linux, and Windows):
+
+```bash
+uv tool install wtg-cli
+wtg --help
+```
+
+### Alternative: build/install from source
+
+```bash
+cargo install wtg-cli
+```
+
+## Usage
+
+### Local Repository
+
+Simply run `wtg` with any of the following:
+
+```bash
+# Find a commit by hash
+wtg c62bbcc
+
+# Find an issue or PR
+wtg 123
+wtg #123
+
+# Find a file
+wtg Cargo.toml
+
+# Find a tag
+wtg v1.2.3
+```
+
+### Remote Repository
+
+Query any GitHub repository without cloning it first:
+
+```bash
+# Using -r flag with owner/repo
+wtg -r astral-sh/uv 0.5.0
+
+# Using full GitHub URL
+wtg -r https://github.com/astral-sh/uv v0.5.0
+
+# Paste any GitHub URL directly
+wtg https://github.com/astral-sh/uv/commit/abc123
+wtg https://github.com/astral-sh/uv/issues/42
+wtg https://github.com/astral-sh/uv/pull/123
+wtg https://github.com/astral-sh/uv/blob/main/README.md
+```
+
+**Note**: Remote repositories are cached in your system's cache directory for faster subsequent queries. The cache uses `--filter=blob:none` (Git 2.17+) for minimal disk usage, with automatic fallback to bare clones on older Git versions.
+
+## Output Examples
+
+### Commit
+```
+🔍 Found commit: c4e0cc8e98d3
+
+💻 The Commit:
+   Hash: c4e0cc8
+   👤 Who wrote this gem:
+      mishamsk (5206955+mishamsk@users.noreply.github.com)
+      🔗 https://github.com/mishamsk
+   📝 ⬇️ reduce msrv
+   📅 2024-11-07 03:37:26
+   🔗 https://github.com/mishamsk/sas-lexer/commit/c4e0cc8e98d3e786916ac811c5617ecb68d1a6fd
+
+📦 First shipped in:
+   🎉 rust-v1.0.0-beta.3 (rust-v1.0.0-beta.3)
+   📅 2024-11-08 03:03:21 U
+   🔗 https://github.com/mishamsk/sas-lexer/releases/tag/rust-v1.0.0-beta.3
+```
+
+## GitHub Authentication
+
+For better rate limits, set a GitHub token:
+
+1. **Environment variable** (recommended):
+   ```bash
+   export GITHUB_TOKEN=ghp_your_token_here
+   ```
+
+2. **GitHub CLI**: wtg automatically reads from `~/.config/gh/hosts.yml` if you have `gh` installed
+
+3. **Anonymous**: Works without auth but has lower rate limits (60 requests/hour)
+
+## How It Works
+
+1. Opens your git repository
+2. Tries to identify the input type (commit, issue, file, tag)
+3. Fetches additional info from GitHub API if available
+4. Finds the closest release that contains the commit
+5. Displays everything in a beautiful, colorful format
+
+## Limitations
+
+- Only supports GitHub (GitLab and others coming... maybe?)
+- Squashed commits detection not yet implemented
+- No TUI mode (planned for future)
+
+## License
+
+MIT
+
+## Contributing
+
+Found a bug? Want to add a snarky message? PRs welcome! Just make sure to keep the snark levels high and the code quality higher.
+

wtg_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+wtg_cli-0.1.0.dist-info/METADATA,sha256=-c0zm8D-MHRar4hsatWEVns8q0DHUN4hONrf41WUhP0,4541
+wtg_cli-0.1.0.dist-info/WHEEL,sha256=TJQY77QRLvXq32tEs9ATmwKO6NAOtuKOAw50eyiSmWU,96
+wtg_cli-0.1.0.dist-info/entry_points.txt,sha256=v3pdriVnHV-N7dP3Y9bbhUFno6m-gRk_57hNq4vNFgA,39
+wtg_cli-0.1.0.dist-info/licenses/LICENSE,sha256=5beZsDWkpy61sDNmto1ClYsqh_KnowEDb3YcWuRHfMk,1089
+wtg_cli/__init__.py,sha256=hyOom6FHhDhBYwXHgn49jUwHg8b4oPpH3RONGar821o,363
+wtg_cli/__main__.py,sha256=y-tanBpdvSApMQqB0CKa2rRfKw9eaCGsQEZEuM6NoGo,131
+wtg_cli/_wtg.cp313-win_amd64.pyd,sha256=dUBbm5FQv_loo_tTpmkodfLmrBSpzpgQk1b9zJsap0I,9818112
+wtg_cli/cli.py,sha256=RaQY4DKipZo7OmARWSQyMhCs_RPxDk-8UBD3ktMKwi0,840
+wtg_cli-0.1.0.dist-info/RECORD,,

wtg_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64

wtg_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wtg=wtg_cli.cli:main

wtg_cli-0.1.0.dist-info/licenses/LICENSE

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