Metadata-Version: 2.4
Name: hardpycover
Version: 0.1.3
Summary: Hardcover API wrapper for Python
Keywords: hardcover,api,wrapper,graphql
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: pydantic>=2.11.4
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: sgqlc>=16.4
Requires-Dist: sgqlc ; extra == 'with-sgql'
Maintainer: Jay Cruz
Maintainer-email: Jay Cruz <jccruz009@yahoo.com>
Requires-Python: >=3.10
Provides-Extra: with-sgql
Description-Content-Type: text/markdown

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

<h1 align="left">
  hardpycover
</h1>
<p align="left">
  <b>Simplified API Wrapper for Hardcover, written in Python.</b>
</p>

![PyPI - Version](https://img.shields.io/pypi/v/hardpycover)

<hr />

### Installation

**pip**
```
pip install hardpycover
```

**uv**
```
uv add hardpycover
```

### Usage

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

```python3
import os
from hardpycover 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](/hardpycover/main.py).

### Contributors
<a href="https://github.com/jmcruz14/hardpycover/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=jmcruz14/hardpycover" />
</a>

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