aiowowapi


Nameaiowowapi JSON
Version 2.1.5 PyPI version JSON
download
home_pagehttps://github.com/Adalyia/aiowowapi
SummaryAn asynchronous Python wrapper for the World of Warcraft APIs.
upload_time2024-10-28 20:44:32
maintainerNone
docs_urlNone
authorAdalyia
requires_python>=3.8
licenseMIT
keywords wow world of warcraft api wrapper asynchronous async battle.net blizzard
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://img.shields.io/pypi/v/aiowowapi.svg
   :target: https://pypi.python.org/pypi/aiowowapi
   :alt: PyPI version info
.. image:: https://img.shields.io/pypi/pyversions/aiowowapi.svg
   :target: https://pypi.python.org/pypi/aiowowapi
   :alt: PyPI supported Python versions
.. image:: https://github.com/Adalyia/aiowowapi/actions/workflows/tests.yml/badge.svg
   :target: https://github.com/Adalyia/aiowowapi/actions/workflows/tests.yml
   :alt: Test Status
.. image:: https://readthedocs.org/projects/aiowowapi/badge/?version=latest
   :target: https://aiowowapi.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status

aiowowapi docs
=====================================

Warning: I have personally stopped playing World of Warcraft, if you'd like to take over maintenance of the project or see any issues you can create an issue on GitHub and I promise I'll look into it ASAP.

An asynchronous client library for interacting with the World of Warcraft API endpoints using the ``async`` / ``await`` syntax.


Installing
-----------
.. code:: sh

    # Linux/OSX
    python3 -m pip install -U aiowowapi

    # Windows
    python -m pip install -U aiowowapi


Current Features
---------------------
* Retail Game Data API Support
* Retail Profile API Support
* Classic Game Data API Support
* Rate limiting
* Request retries
* QoL WoW-Specific functions (Money -> Gold/Silver/Copper, Armoury link parser, etc)

TODO
-----
* Add caching for certain requests (e.g. character profile)
* Greater test coverage

Requirements
-------------
* `aiohttp <https://docs.aiohttp.org/en/stable/>`_
* Python 3.8+

Example
--------
.. code-block:: python

    from aiowowapi import WowApi

    async def main():
        async with WowApi('<ID>','<SECRET>', 'us', request_debugging=True) as Client:
            print(await Client.Retail.Profile.get_character_profile_status('illidan', 'adalyia'))


Links
------
* `aiowowapi's Documentation <https://aiowowapi.readthedocs.io/en/latest/>`_
* `Blizzard's API Documentation <https://develop.battle.net/documentation>`_
* `Register a Blizzard API Client <https://develop.battle.net/access/clients>`_
* `Blizzard's API Forums <https://us.forums.blizzard.com/en/blizzard/c/api-discussion/18>`_


IMPORTANT
----------
This project is not affiliated with or endorsed by `Blizzard Entertainment <https://www.blizzard.com/>`_ & all data is retrieved from official Blizzard / World of Warcraft APIs. `Terms found here <https://www.blizzard.com/en-us/legal/a2989b50-5f16-43b1-abec-2ae17cc09dd6/blizzard-developer-api-terms-of-use>`_. Additionally this project was created primarily for use with Discord Bots & other async applications with inspiration from `this project <https://github.com/lockwooddev/python-wowapi>`_ by `lockwooddev <https://github.com/lockwooddev/>`_.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Adalyia/aiowowapi",
    "name": "aiowowapi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "wow, world of warcraft, api, wrapper, asynchronous, async, battle.net, blizzard",
    "author": "Adalyia",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/f0/74/0f21242eaff96b036a39977d97d58d8174f18febabb6f45087abf9bc2fb3/aiowowapi-2.1.5.tar.gz",
    "platform": null,
    "description": ".. image:: https://img.shields.io/pypi/v/aiowowapi.svg\r\n   :target: https://pypi.python.org/pypi/aiowowapi\r\n   :alt: PyPI version info\r\n.. image:: https://img.shields.io/pypi/pyversions/aiowowapi.svg\r\n   :target: https://pypi.python.org/pypi/aiowowapi\r\n   :alt: PyPI supported Python versions\r\n.. image:: https://github.com/Adalyia/aiowowapi/actions/workflows/tests.yml/badge.svg\r\n   :target: https://github.com/Adalyia/aiowowapi/actions/workflows/tests.yml\r\n   :alt: Test Status\r\n.. image:: https://readthedocs.org/projects/aiowowapi/badge/?version=latest\r\n   :target: https://aiowowapi.readthedocs.io/en/latest/?badge=latest\r\n   :alt: Documentation Status\r\n\r\naiowowapi docs\r\n=====================================\r\n\r\nWarning: I have personally stopped playing World of Warcraft, if you'd like to take over maintenance of the project or see any issues you can create an issue on GitHub and I promise I'll look into it ASAP.\r\n\r\nAn asynchronous client library for interacting with the World of Warcraft API endpoints using the ``async`` / ``await`` syntax.\r\n\r\n\r\nInstalling\r\n-----------\r\n.. code:: sh\r\n\r\n    # Linux/OSX\r\n    python3 -m pip install -U aiowowapi\r\n\r\n    # Windows\r\n    python -m pip install -U aiowowapi\r\n\r\n\r\nCurrent Features\r\n---------------------\r\n* Retail Game Data API Support\r\n* Retail Profile API Support\r\n* Classic Game Data API Support\r\n* Rate limiting\r\n* Request retries\r\n* QoL WoW-Specific functions (Money -> Gold/Silver/Copper, Armoury link parser, etc)\r\n\r\nTODO\r\n-----\r\n* Add caching for certain requests (e.g. character profile)\r\n* Greater test coverage\r\n\r\nRequirements\r\n-------------\r\n* `aiohttp <https://docs.aiohttp.org/en/stable/>`_\r\n* Python 3.8+\r\n\r\nExample\r\n--------\r\n.. code-block:: python\r\n\r\n    from aiowowapi import WowApi\r\n\r\n    async def main():\r\n        async with WowApi('<ID>','<SECRET>', 'us', request_debugging=True) as Client:\r\n            print(await Client.Retail.Profile.get_character_profile_status('illidan', 'adalyia'))\r\n\r\n\r\nLinks\r\n------\r\n* `aiowowapi's Documentation <https://aiowowapi.readthedocs.io/en/latest/>`_\r\n* `Blizzard's API Documentation <https://develop.battle.net/documentation>`_\r\n* `Register a Blizzard API Client <https://develop.battle.net/access/clients>`_\r\n* `Blizzard's API Forums <https://us.forums.blizzard.com/en/blizzard/c/api-discussion/18>`_\r\n\r\n\r\nIMPORTANT\r\n----------\r\nThis project is not affiliated with or endorsed by `Blizzard Entertainment <https://www.blizzard.com/>`_ & all data is retrieved from official Blizzard / World of Warcraft APIs. `Terms found here <https://www.blizzard.com/en-us/legal/a2989b50-5f16-43b1-abec-2ae17cc09dd6/blizzard-developer-api-terms-of-use>`_. Additionally this project was created primarily for use with Discord Bots & other async applications with inspiration from `this project <https://github.com/lockwooddev/python-wowapi>`_ by `lockwooddev <https://github.com/lockwooddev/>`_.\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "An asynchronous Python wrapper for the World of Warcraft APIs.",
    "version": "2.1.5",
    "project_urls": {
        "Homepage": "https://github.com/Adalyia/aiowowapi"
    },
    "split_keywords": [
        "wow",
        " world of warcraft",
        " api",
        " wrapper",
        " asynchronous",
        " async",
        " battle.net",
        " blizzard"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "21db523c0727ddcc095669cf4f22e7274f256561b0363ca618b7ad706866d80c",
                "md5": "5172ceb0d907fcd34e8cd2f0ea95ebaf",
                "sha256": "a463b1b35ff7e9f7d050b94f721f6e5c92747b0b934b1a803be191d5f57eafcf"
            },
            "downloads": -1,
            "filename": "aiowowapi-2.1.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5172ceb0d907fcd34e8cd2f0ea95ebaf",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 24263,
            "upload_time": "2024-10-28T20:44:31",
            "upload_time_iso_8601": "2024-10-28T20:44:31.275417Z",
            "url": "https://files.pythonhosted.org/packages/21/db/523c0727ddcc095669cf4f22e7274f256561b0363ca618b7ad706866d80c/aiowowapi-2.1.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f0740f21242eaff96b036a39977d97d58d8174f18febabb6f45087abf9bc2fb3",
                "md5": "e7f4fc2f1f2a039629dcc0c99b671bae",
                "sha256": "02efc0186bdfdd16a6d3ca5f369d63bbe0f38193b75c308989a5d0001e140d00"
            },
            "downloads": -1,
            "filename": "aiowowapi-2.1.5.tar.gz",
            "has_sig": false,
            "md5_digest": "e7f4fc2f1f2a039629dcc0c99b671bae",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 23811,
            "upload_time": "2024-10-28T20:44:32",
            "upload_time_iso_8601": "2024-10-28T20:44:32.438130Z",
            "url": "https://files.pythonhosted.org/packages/f0/74/0f21242eaff96b036a39977d97d58d8174f18febabb6f45087abf9bc2fb3/aiowowapi-2.1.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-28 20:44:32",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Adalyia",
    "github_project": "aiowowapi",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "aiowowapi"
}
        
Elapsed time: 0.37161s