Metadata-Version: 2.4
Name: github-rest-sdk
Version: 0.1.1
Summary: A lightweight typed Python wrapper for the GitHub REST API.
Author-email: Ankit Jha <reachankitjha@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/KaunAnkit/github-api-wrapper
Project-URL: Repository, https://github.com/KaunAnkit/github-api-wrapper
Keywords: github,api,wrapper,sdk,python
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: tenacity>=9.0.0

# GitHub API Wrapper
[![PyPI version](https://img.shields.io/pypi/v/github-api-wrapper-py.svg)](https://pypi.org/project/github-api-wrapper-py/)
[![Python](https://img.shields.io/pypi/pyversions/github-api-wrapper-py.svg)](https://pypi.org/project/github-api-wrapper-py/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
A lightweight, typed Python SDK for interacting with the GitHub REST API.

## Features

- Typed Pydantic models
- User API
- Repository API
- Repository search
- Automatic pagination
- Custom exceptions
- Built on httpx

## Installation

```bash
pip install github-rest-sdk
```

## Quick Start

```python
from github_api import GitHubClient

client = GitHubClient("YOUR_GITHUB_TOKEN")

user = client.get_user("torvalds")
print(user.login)

repo = client.get_repo("openai", "openai-python")
print(repo.stars)
```

## Available Methods

### Users

```python
client.get_user(username)
client.list_user_repos(username)
client.list_all_user_repos(username)
```

### Repositories

```python
client.get_repo(owner, repo)
client.search_repositories(query)
```

## Project Structure

```
github_api/
├── client.py
├── models.py
├── exceptions.py
└── __init__.py
```

## Roadmap

- [ ] Async client
- [ ] More GitHub endpoints
- [ ] Comprehensive test suite
- [ ] GitHub Actions CI

## License

MIT
