Metadata-Version: 2.1
Name: blurple.py
Version: 1.0.0
Summary: A front-end framework for discord.py
Home-page: https://github.com/LeptoFlare/blurple.py
Author: LeptoFlare
License: MIT
Project-URL: Issues, https://github.com/LeptoFlare/blurple.py/issues
Project-URL: Docs, https://lepto.tech/blurple.py
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: discord.py
Requires-Dist: python-dateutil

# `blurple.py`
> A front-end framework for discord.py

[![PyPI][pypi-shield]](https://pypi.org/project/blurple.py)
![License][license-shield]
![Stars][stars-shield]
#

Blurple.py is a framework built on top of discord.py, giving you the tools you need to build discord bots with convenience.

> :warning: hey! thanks for checking this library out. please note that this library is not currently being maintained. that being said, you probably won't encounter any issues if you choose to still use it!

Here's what's included:
1. `blurple.ui` All the styled components you'll ever need for building user interfaces in discord.
    - Styled alerts, toasts that automatically dismiss, and more.
2. `blurple.io` Robust functions that enable you to build stable, multi-step commands with ease.
    - Support for multi-event replies, and timeout handling by default.
3. `blurple.ext` Utilities and sane defaults for discord.ext commands.
    - Drop-in replacements, addons, and other small gadgets.

## usage <!-- Using the product -->
_Documentation can be found [here](https://cerusabi.github.io/blurple.py)._

### installation
1. Make sure your python version is up-to-date.
1. Install the package with `pip install blurple.py`.

### example with `blurple.ui`
```diff
  import discord
  from discord.ext import commands
+ from blurple import ui

  bot = commands.Bot(command_prefix='!')

  @bot.command()
  async def ping(ctx):
-     await ctx.send('Pong!')
+     await ctx.send(embed=ui.Alert(ui.Style.SUCCESS,
+         title="Pong!",
+         description=f"Latency: `{round(bot.latency*1000)}ms`")
+     )

  bot.run('token')
```

![Usage](usage.png)


## running locally
1. Clone the repository
    `git clone https://github.com/LeptoFlare/blurple.py.git`
1. Create a `.env` in the repository root with your token:
    `TOKEN=kpXVCJ9.pLY.Q6m9F`
1. The repo contains a `test.py` file used for testing, simply run the file
    `python3 test.py`

---

[**@cerusabi**](https://github.com/LeptoFlare) • [cerusabi.github.io](https://cerusabi.github.io)

<!-- markdown links & imgs -->
[pypi-shield]: https://img.shields.io/pypi/v/blurple.py.svg
[stars-shield]: https://img.shields.io/github/stars/LeptoFlare/blurple.py.svg?style=social
[license-shield]: https://img.shields.io/github/license/LeptoFlare/blurple.py.svg?style=flat
