Metadata-Version: 2.4
Name: fluxpoint.py
Version: 0.2.0
Summary: A Python wrapper for the Fluxpoint API
Home-page: https://github.com/Creatrix-Net/fluxpoint.py
Author: Dhruva Shaw
License: GNU GENERAL PUBLIC LICENSE
Project-URL: fluxpoint.py API wrapper Docs, https://fluxpointpy.dhruvashaw.in
Project-URL: Official Api Docs, https://docs.fluxpoint.dev/api
Project-URL: Get Api Token, https://fluxpoint.dev/api/access
Project-URL: Offcial Fluxpoint discord server, https://discord.gg/fluxpoint
Project-URL: Support server for api wrapper, https://discord.gg/vfXHwS3nmQ
Project-URL: Repository, https://github.com/Creatrix-Net/fluxpoint.py
Project-URL: Examples Directory, https://github.com/Creatrix-Net/fluxpoint.py/tree/master/examples
Project-URL: Issue tracker, https://github.com/Creatrix-Net/fluxpoint.py/issues
Keywords: fluxpoint api,api,wrapper,async wrapper
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Classifier: Topic :: Communications
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.1
Requires-Dist: yarl>=1.7.2
Provides-Extra: speed
Requires-Dist: aiohttp[speedups]>=3.8.1; extra == "speed"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinxcontrib_trio; extra == "docs"
Requires-Dist: sphinxcontrib-websupport; extra == "docs"
Requires-Dist: sphinx-autoapi; extra == "docs"
Requires-Dist: typing-extensions; extra == "docs"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

fluxpoint.py
================

.. image:: https://discord.com/api/guilds/920190307595874304/embed.png
   :target: https://discord.gg/vfXHwS3nmQ
   :alt: Discord server invite
.. image:: https://img.shields.io/pypi/v/fluxpoint.py.svg
   :target: https://pypi.python.org/pypi/fluxpoint.py
   :alt: PyPI version info
.. image:: https://img.shields.io/pypi/pyversions/fluxpoint.py.svg
   :target: https://pypi.python.org/pypi/fluxpoint.py
   :alt: PyPI supported Python versions

A modern, easy to use, feature-rich, and async ready API wrapper for Fluxpoint written in Python.

Key Features
--------------

- Modern Pythonic API using ``async`` and ``await``.
- Proper rate limit handling.
- Optimised in both speed and memory.

Installing
----------

**Python 3.9 or higher is required**

To install the library, you can just run the following command:

.. code:: sh

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

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

To speedup the api wrapper you should run the following command:

.. code:: sh

    # Linux/macOS
    python3 -m pip install -U "fluxpoint.py[speed]"

    # Windows
    py -3 -m pip install -U fluxpoint.py[speed]


To install the development version, do the following:

.. code:: sh

    $ git clone https://github.com/Creatrix-Net/fluxpoint.py
    $ cd fluxpoint.py
    $ python3 -m pip install -U .[speed]


Quick Example
---------------

.. code:: py

      from fluxpoint import FluxpointClient
      import asyncio
      import sys

      # setting up the fluxpoint client handler
      a = FluxpointClient(api_token="get api token from fluxpoint.dev/api/access")

      # setting up the windows loop policy according to the operating system
      if sys.platform.startswith('win32') or sys.platform.startswith('cygwin'):
          asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

      # getting the random dadjoke
      print(asyncio.run(a.dadjoke()))


You can find more examples in the `examples directory <https://github.com/Creatrix-Net/fluxpoint.py/tree/master/examples>`_.

Links
------

- `Documentation <https://fluxpointpy.dhruvashaw.in/en/latest/>`_
- `Official Support Discord Server <https://discord.gg/vfXHwS3nmQ>`_
- `Official Fluxpoint server <https://discord.gg/fluxpoint>`_
- `Get Fluxpoint api access <https://fluxpoint.dev/api/access>`_
- `Official Fluxpoint api docs <https://docs.fluxpoint.dev/api>`_
