semvec/pypi-packages huggingface dataset:
tcgplayer-api 0.0.3
A Python client library for the TCGPlayer API.
Requires Python: >=3.6
Keywords: mtg magic the gathering tcg player api client

TCGPlayer-API
======================================== 
<a href="https://pypi.org/project/tcgplayer-api/"><img src="https://img.shields.io/pypi/v/tcgplayer-api?style=for-the-badge" alt="latest release" /></a>
<a href="https://pypi.org/project/tcgplayer-api/"><img src="https://img.shields.io/pypi/pyversions/tcgplayer-api?style=for-the-badge" alt="supported python versions" /></a>
<a href="https://pypi.org/project/tcgplayer-api/"><img src="https://img.shields.io/pypi/status/tcgplayer-api?style=for-the-badge" alt="package status" /></a>
<a href="https://github.com/ZaxR/tcgplayer-api-client-python/blob/master/LICENSE"><img src="https://img.shields.io/pypi/l/tcgplayer-api?style=for-the-badge" alt="license" /></a>

A Python client library for the [TCGPlayer API](https://docs.tcgplayer.com/docs)


Installation
=============

```bash
pip install tcgplayer-api
```

Note that the latest version of tcgplayer-api will only be compatible with newer version of Python. This is to allow tcgplayer-api to take advantage of the latest language/library features and to reduce the technical debt of maintaining tcgplayer-api. See the table below for officially supported versions:

| tcgplayer-api | Python |
|:-------------:|:------:|
|     0.0.1     |  >=3.6 |


Example Usage
==============

```
>>> from tcgplayer_api.auth import BearerAuth
>>> from tcgplayer_api.client import TCGPlayerClient


>>> PUBLIC_KEY = "x"
>>> PRIVATE_KEY = "y"
>>> auth = BearerAuth(public_key=PUBLIC_KEY, private_key=PRIVATE_KEY)

>>> client = TCGPlayerClient(auth=auth)
>>> client.list_all_categories()
{'totalItems': 61,
 'success': True,
 'errors': [],
 'results': [{'categoryId': 55,
   'name': 'Architect TCG',
   'modifiedOn': '2018-09-17T15:21:54.233',
   'displayName': 'Architect TCG',
   'seoCategoryName': 'Architect TCG',
   'sealedLabel': 'Sealed Products',
   'nonSealedLabel': 'Singles',
   'conditionGuideUrl': 'https://store.tcgplayer.com/',
   'isScannable': True,
   'popularity': 0},
  ...
 ]
}
```

Roadmap to v1.0.0
==============
- Fix support for post and other request types besides get
- Add pagination support for responses
- Add module/func docstrings
- Add basic documentation
- Add parameters to v1.37.0.json
- Improve endpoint methods' docstrings to include arg info
- Add more meaningful error messages when required params are missing or for various status codes