Metadata-Version: 2.1
Name: gw2apy
Version: 0.0.2
Summary: Guild Wars 2 API Python Wrapper
Home-page: https://github.com/GuillaumeRochette/gw2apy/
Author: Guillaume Rochette
Author-email: rochette.guillaume@gmail.com
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/GuillaumeRochette/gw2apy/issues
Project-URL: Source, https://github.com/GuillaumeRochette/gw2apy/
Platform: UNKNOWN
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.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests-futures (>=1.0.0)
Requires-Dist: ratelimit (>=2.2.1)

# Guild Wars 2 API Python Wrapper

[![Build Status](https://www.travis-ci.com/GuillaumeRochette/gw2apy.svg?branch=master)](https://www.travis-ci.com/GuillaumeRochette/gw2apy)
[![Latest Version](https://img.shields.io/pypi/v/gw2apy.svg)](https://pypi.org/project/gw2apy/)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/gw2apy.svg)](https://pypi.org/project/gw2apy/)

## Installation
- Pre-requisites: Python >= 3.6
- Install the [package](https://pypi.org/project/gw2apy/) from PyPi directly:
```bash
pip install gw2apy
```

## Quickstart
- Create a client:
```python
from gw2apy.client import Client

client = Client()
```
You can specify an API key to access authenticated endpoints, such as bank content or wallet:
```python
client = Client(api_key="YOUR_API_KEY")
```

- Create an endpoint, e.g. Items: 
```python
from gw2apy.endpoints import Items

items_endpoint = Items(client=client)
```

- Request data from the endpoint:
```python
# Returns the list of ids for all available items.
items_ids = items_endpoint.endpoint()

# Return the item associated to an id.
item = items_endpoint.id(id=28445)

# Return a list of item given a list of ids.
items = items_endpoint.ids(ids=[28445, 12452])

# Return a list of all the items.
all_items = items_endpoint.all()
```

## Credits
This package is inspired from:
- [JuxhinDB/gw2-api-interface](https://github.com/JuxhinDB/gw2-api-interface)
- [queicherius/gw2api-client](https://github.com/queicherius/gw2api-client)


