gh-store

0.11.3 verified Sat May 09 auth: no python

A lightweight data store that uses GitHub Issues as a backend. Current version: 0.11.3. Requires Python 3.11-3.13. Release cadence: irregular.

pip install gh-store

Common errors

error TypeError: GitHubStore.__init__() got an unexpected keyword argument 'template' ↓

cause In v0.11.0, the parameter was renamed from `template` to `issue_template`.

fix

Replace template='...' with issue_template='...'.

error ghost.GitHubError: 404 Not Found ↓

cause Repository does not exist or token lacks access, or the issue_template label does not exist.

fix

Verify repo is 'owner/repo' and token has repo scope. Create the issue_template label in the repo.

Warnings

breaking In v0.11.0, the `issue_template` parameter was renamed from `template` to `issue_template`. Old code using `template` will raise TypeError. ↓

fix Change `template='data'` to `issue_template='data'`.

gotcha Store operations count against GitHub API rate limits (5000 requests/hour for authenticated users). Bulk operations can exhaust limits quickly. ↓

fix Consider batching or caching. Use a GITHUB_TOKEN with sufficient scope.

Imports

GitHubStore
wrong
```
import gh_store
```
correct
```
from gh_store import GitHubStore
```
GitHubStore is the main class; top-level import will not expose it.

Quickstart

Initialize with a GitHub personal access token and repo, then set/get key-value pairs.

from gh_store import GitHubStore
import os

store = GitHubStore(
    token=os.environ.get('GITHUB_TOKEN', ''),
    repo='owner/repo',
    issue_template='data'
)
store.set('key', {'value': 42})
print(store.get('key'))