ghizmo

0.2.0 verified Sat May 09 auth: no python

ghizmo is an extensible command-line interface for GitHub, built on click and PyGithub. It provides commands for issues, pull requests, releases, and contributor stats. Current version is 0.2.0, with a low release cadence (sporadic updates).

pip install ghizmo

Common errors

error ModuleNotFoundError: No module named 'ghizmo' ↓

cause ghizmo not installed or not importable as a library.

fix

Install via pip install ghizmo, and use it as CLI tool, not import.

error KeyError: 'GITHUB_TOKEN' ↓

cause Missing environment variable GITHUB_TOKEN.

fix

Set GITHUB_TOKEN environment variable with a valid token.

error github.GithubException: Bad credentials ↓

cause Invalid or expired GitHub token.

fix

Generate a new token at https://github.com/settings/tokens.

Warnings

deprecated PyGithub dependency is unmaintained; ghizmo may break with GitHub API changes. ↓

fix Consider using the gh CLI or a more actively maintained library.

gotcha GITHUB_TOKEN environment variable is required. Missing token causes silent failures. ↓

fix Set GITHUB_TOKEN before using ghizmo.

gotcha Commands may fail with rate limiting if no token or insufficient permissions. ↓

fix Use a token with appropriate scopes (e.g., repo).

Imports

ghizmo CLI
```
import ghizmo
```
ghizmo is used as a command-line tool; it is not typically imported as a Python library.

Quickstart

Basic usage: configure GITHUB_TOKEN and call a command.

import os
import ghizmo

# Set your GitHub token in environment
os.environ['GITHUB_TOKEN'] = os.environ.get('GITHUB_TOKEN', '')

# Run CLI commands via ghizmo.cli
from ghizmo.commands import issues
issues.list_issues('jlevy/ghizmo')