Metadata-Version: 2.4
Name: osu.py
Version: 4.0.2
Summary: API Wrapper for osu!api v2 written in Python.
Home-page: https://github.com/Sheepposu/osu.py
Author: Sheepposu
License: MIT
Project-URL: Bug Tracker, https://github.com/Sheepposu/osu.py/issues
Project-URL: osu.py documentation, https://osupy.readthedocs.io/
Project-URL: osu!api v2 documentation, https://osu.ppy.sh/docs/index.html
Project-URL: Code examples, https://github.com/Sheepposu/osu.py/tree/main/examples
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Intended Audience :: Developers
Requires-Python: >=3.8.0
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: requests<3,>=2.25.1
Provides-Extra: async
Requires-Dist: aiohttp<4,>=3.9.2; extra == "async"
Provides-Extra: replay
Requires-Dist: osrparse<8,>=7.0.1; extra == "replay"
Provides-Extra: notifications
Requires-Dist: websockets<14,>=13.1; extra == "notifications"
Provides-Extra: tests
Requires-Dist: pytest<9,>=8.3.3; extra == "tests"
Requires-Dist: pytest-asyncio<1,>=0.24.0; extra == "tests"
Requires-Dist: pytest-dependency<1,>=0.6.0; extra == "tests"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

osu.py
------

.. image:: https://discordapp.com/api/guilds/836755328493420614/widget.png?style=shield
   :target: https://discord.gg/Z2J6SSRPcE
   :alt: Discord server invite
.. image:: https://img.shields.io/pypi/v/osu.py.svg
   :target: https://pypi.python.org/pypi/osu.py
   :alt: PyPI version info
.. image:: https://static.pepy.tech/personalized-badge/osu-py?period=month&units=international_system&left_color=blue&right_color=brightgreen&left_text=Downloads/month
   :target: https://pepy.tech/project/osu-py
   :alt: Download metric
.. image:: https://readthedocs.org/projects/osupy/badge/?version=v1.0.0&style=flat
   :target: https://osupy.readthedocs.io
   :alt: Documentation

Easy-to-use API wrapper for osu!api v2 written in Python.
Has a high-level interface while still allowing ways to do more complex things.

Major features/capabilities
---------------------------
- Python 3.8+
- Client class that supports all endpoints
- ``AsynchronousClient`` for async requests
- Supports Authorization Code Grant, Client Credentials Grant, and all scopes (except lazer)
- Builtin rate limit handling and ability to tweak it
- Storage-efficient objects
- Refresh and access tokens are automatically managed
- Quality of life functions, enums, and designs
- Extensive documentation

Installation
------------

.. code:: sh

    # Installs the latest version out on pypi

    # Linux/macOS
    python3 -m pip install -U osu.py

    # Windows
    py -3 -m pip install -U osu.py

    # Installing straight from github (downloads latest code, which is not guaranteed to be stable)
    py -m pip install git+https://github.com/Sheepposu/osu.py.git

    # Install with asynchronous client
    py -m pip install -U osu.py[async]
    # Install with all features
    py -m pip install -U osu.py[async,replay,notifications]

    # Install from github with features
    git clone https://github.com/sheppsu/osu.py
    cd osu.py
    py -m pip install -U .[async,replay,notifications]

Example
-------

.. code:: py

    from osu import Client, GameModeStr

    client = Client.from_credentials(0, "*****", None)
    user = client.get_user(14895608, GameModeStr.STANDARD)
    print(user)

Links
-----

- `Issues <https://github.com/Sheppsu/osu.py/issues>`_
- `Contribute <https://github.com/Sheppsu/osu.py/pulls>`_
- `Discussion <https://github.com/Sheppsu/osu.py/discussions>`_
- `Discord server <https://discord.gg/Z2J6SSRPcE>`_
- `Example code <https://github.com/Sheppsu/osu.py/tree/main/examples>`_
- `Getting started guide <https://osupy.readthedocs.io/en/latest/guide.html>`_
- `Documentation <https://osupy.readthedocs.io>`_
