Metadata-Version: 2.4
Name: hardpycover
Version: 0.1.1
Summary: Hardcover API wrapper for Python
Keywords: hardcover,api,wrapper,graphql
License-Expression: MIT
Requires-Dist: pydantic>=2.11.4
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: urllib3>=2.4.0
Requires-Dist: sgqlc ; extra == 'with-sgql'
Maintainer: Jay Cruz
Maintainer-email: Jay Cruz <jccruz009@yahoo.com>
Requires-Python: >=3.11
Provides-Extra: with-sgql
Description-Content-Type: text/markdown

## hardcoverpy

Simplified API Wrapper for Hardcover, written in Python.

> [!WARNING] 
> This package is currently in Alpha development, so download at your own risk.

### Installation

**pip**
```
pip install hardcoverpy
```

**uv**
```
uv add hardcoverpy
```

### Usage

> [!NOTE] 
> Using `hardcoverpy` requires having an API Key from Hardcover. To avail of an API Key, go to https://hardcover.app/account/api.

```python3
import os
from hardcoverpy import Hardcover

# Store your API_KEY in an .env file
api_key = os.environ["API_KEY"]

# create hardcover instance
hc = Hardcover(api_key=api_key)
```

**Getting User Information**
```python3
hc.user_profile(['id', 'bio', 'created_at', 'username'])
# > {
# 'id': 2,
# 'bio' 'Lorem ipsum dolores amit',
# 'created_at': '2025-06-23T10:10:10.32341Z',
# 'username': 'kennyrogers'
# }
```

For more use cases, read the available methods found at [main.py](/hardcoverpy/main.py).

### Contributors
<!-- readme: contributors -start -->
<!-- readme: contributors -end -->

### License
[MIT License](/LICENSE) – Free to use, modify, and share.