bt-ghcli 0.3.0__tar.gz

bt_ghcli-0.3.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: bt-ghcli
+Version: 0.3.0
+Summary: CLI for interacting with the GitHub API
+Author-email: Bert Tejeda <berttejeda@gmail.com>
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.31.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: PyYAML>=6.0.0
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: bt-credmgr>=0.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.1; extra == "dev"

bt_ghcli-0.3.0/README.md

@@ -0,0 +1,216 @@
+# bt-ghcli
+
+CLI for interacting with the GitHub / GitHub Enterprise API. Provides two tools:
+
+- **`ghpr`** — Pull Request management (create, approve, comment)
+- **`ghsearch`** — Search repositories, code, and commits
+
+## Installation
+
+```bash
+pip install bt-ghcli
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/berttejeda/bert.git-cli.git
+cd bert.git-cli
+pip install -e ".[dev]"
+```
+
+## Authentication
+
+Token resolution follows this precedence (first match wins):
+
+1. `--token` CLI argument
+2. Config file value
+3. Environment variable
+4. OS Keyring (via [bt-credmgr](https://github.com/berttejeda/bert.credmgr))
+
+### Environment Variables
+
+| Tool | Variables (checked in order) |
+|------|------------------------------|
+| `ghpr` | `GHPR_TOKEN` → `GHE_TOKEN` → `GITHUB_TOKEN` |
+| `ghsearch` | `GHSEARCH_TOKEN` → `GITHUB_TOKEN` |
+
+### OS Keyring
+
+If no token is found via CLI, config, or environment, the tool queries the OS password manager using a single, namespaced key:
+
+| Tool | Default keyring key |
+|------|-------------------|
+| `ghpr` | `GHPR_TOKEN` |
+| `ghsearch` | `GHSEARCH_TOKEN` |
+
+Override with `--password-manager-key` / `-PMK`:
+
+```bash
+# Store a token in the OS keyring
+credstore --name GHPR_TOKEN --password <your-token>
+
+# Use a custom keyring key
+ghpr create --password-manager-key MY_CUSTOM_KEY ...
+```
+
+The key can also be set in the config file:
+
+```yaml
+ghpr:
+  password_manager_key: MY_CUSTOM_KEY
+```
+
+## ghpr
+
+GitHub / GitHub Enterprise Pull Request management.
+
+### Create a Pull Request
+
+```bash
+ghpr create --title "Fix bug" --body "Fixes issue #42" --head feature-branch --base main
+
+# Create a draft PR
+ghpr create --title "WIP: Feature" --head feature --base main --draft
+
+# With labels
+ghpr create --title "Feature" --head feature --base main --label bug --label enhancement
+```
+
+### Approve a Pull Request
+
+```bash
+ghpr approve --pr-number 123
+
+# With a comment
+ghpr approve --pr-number 123 --comment "Looks good!"
+```
+
+### Comment on a Pull Request
+
+```bash
+# Review comment
+ghpr comment --pr-number 123 --comment "Great work!" --type review
+
+# Conversational comment
+ghpr comment --pr-number 123 --comment "Thanks for the PR!" --type issue
+```
+
+### Common Options
+
+```
+--config, -c       Path to config file (default: ~/.ghpr.yml)
+--api-base         Override API base URL
+--token, -t        GitHub token for authentication
+--owner, -o        Repository owner/organization
+--repo, -r         Repository name
+--proxy, -x        SOCKS5h proxy address
+--verify-tls       Enable TLS verification (default: True)
+--no-verify-tls    Disable TLS verification
+--password-manager-key, -PMK  Override keyring key (default: GHPR_TOKEN)
+--debug            Show API request details and curl equivalent
+```
+
+### Config File (~/.ghpr.yml)
+
+```yaml
+ghpr:
+  api_base: https://api.github.com
+  token: ghp_xxxxxxxxxxxx
+  owner: my-org
+  repo: my-repo
+  proxy: socks5h://localhost:1080
+  verify_tls: true
+  password_manager_key: GHPR_TOKEN
+```
+
+## ghsearch
+
+GitHub / GitHub Enterprise search for repositories, code, and commits.
+
+### Search Repositories
+
+```bash
+# Search by topic
+ghsearch repos --query "topic:astro topic:template"
+
+# Filter by stars and language
+ghsearch repos --query "language:python" --min-stars 100 --sort-by stars
+
+# Group by language, top 20
+ghsearch repos --query "topic:cli" --group-by-language --top-n 20
+
+# GitHub Enterprise
+ghsearch repos --api-base "https://github.company.com/api/v3" --query "org:myorg"
+```
+
+### Search Code
+
+```bash
+ghsearch code --query "import typer" --repo "owner/repo" --language python
+```
+
+### Search Commits
+
+```bash
+# Search commits
+ghsearch commits --query "fix bug"
+
+# Filter by author
+ghsearch commits --query "refactor" --author "username"
+
+# Repository statistics
+ghsearch commits --query "fix" --stats
+```
+
+### Common Options
+
+```
+--config, -c       Path to config file (default: ~/.ghsearch.yml)
+--api-base         Override API base URL
+--token            GitHub token for authentication
+--query, -q        Search query
+--per-page         Results per page (max 100)
+--max-pages        Maximum pages to fetch
+--verify-tls       Enable TLS verification (default: True)
+--no-verify-tls    Disable TLS verification
+--password-manager-key, -PMK  Override keyring key (default: GHSEARCH_TOKEN)
+--debug            Show API request details and curl equivalent
+```
+
+### Config File (~/.ghsearch.yml)
+
+```yaml
+repos:
+  api_base: https://api.github.com
+  token: ghp_xxxxxxxxxxxx
+  query: "topic:astro"
+  per_page: 50
+  max_pages: 3
+  min_stars: 10
+  sort_by: stars
+  sort_direction: desc
+  group_by_language: true
+  top_n: 20
+  password_manager_key: GHSEARCH_TOKEN
+
+code:
+  query: "import typer"
+  repo: "owner/repo"
+  language: python
+
+commits:
+  query: "fix"
+  author: "username"
+  stats: true
+```
+
+## Running Tests
+
+```bash
+pytest
+```
+
+## License
+
+MIT

bt_ghcli-0.3.0/bt_ghcli.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: bt-ghcli
+Version: 0.3.0
+Summary: CLI for interacting with the GitHub API
+Author-email: Bert Tejeda <berttejeda@gmail.com>
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.31.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: PyYAML>=6.0.0
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: bt-credmgr>=0.2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.1; extra == "dev"

bt_ghcli-0.3.0/bt_ghcli.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+setup.py
+bt_ghcli.egg-info/PKG-INFO
+bt_ghcli.egg-info/SOURCES.txt
+bt_ghcli.egg-info/dependency_links.txt
+bt_ghcli.egg-info/entry_points.txt
+bt_ghcli.egg-info/requires.txt
+bt_ghcli.egg-info/top_level.txt
+ghpr/__init__.py
+ghpr/cli.py
+ghsearch/__init__.py
+ghsearch/cli.py
+tests/test_ghpr.py
+tests/test_ghsearch.py

bt_ghcli-0.3.0/bt_ghcli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bt_ghcli-0.3.0/bt_ghcli.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ghpr = ghpr.cli:main
+ghsearch = ghsearch.cli:main

bt_ghcli-0.3.0/bt_ghcli.egg-info/requires.txt

@@ -0,0 +1,10 @@
+requests>=2.31.0
+httpx>=0.26.0
+PyYAML>=6.0.0
+typer[all]>=0.9.0
+bt-credmgr>=0.2.0
+
+[dev]
+pytest>=7.4.0
+pytest-cov>=4.1.0
+pytest-mock>=3.11.1

bt_ghcli-0.3.0/bt_ghcli.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+ghpr
+ghsearch

bt_ghcli-0.3.0/ghpr/__init__.py

@@ -0,0 +1,38 @@
+"""
+ghpr provides a GitHub/GitHub Enterprise Pull Request management CLI.
+"""
+from .cli import app
+
+__all__ = ["app", "__version__"]
+
+try:
+    from importlib.metadata import version, PackageNotFoundError
+except ImportError:
+    # Python < 3.8
+    try:
+        from importlib_metadata import version, PackageNotFoundError
+    except ImportError:
+        PackageNotFoundError = Exception
+        def version(package_name):
+            raise PackageNotFoundError
+
+try:
+    __version__ = version("bt-ghcli")
+except (PackageNotFoundError, Exception):
+    # Package not installed, fall back to reading from pyproject.toml
+    import re
+    from pathlib import Path
+    
+    pyproject_path = Path(__file__).parent.parent / "pyproject.toml"
+    if pyproject_path.exists():
+        content = pyproject_path.read_text(encoding="utf-8")
+        match = re.search(r'version\s*=\s*["\']([^"\']+)["\']', content)
+        if match:
+            __version__ = match.group(1)
+        else:
+            __version__ = "0.0.0"
+    else:
+        __version__ = "0.0.0"
+
+
+