Metadata-Version: 2.1
Name: vacefron.py
Version: 1.0.2
Summary: A Wrapper for vacefron.nl/api written in Python.
Home-page: https://github.com/Soheab/vacefron.py
Author: Soheab_
License: MIT
Download-URL: https://github.com/Soheab/vacefron.py/archive/v1.0.2.tar.gz
Project-URL: Discord, https://discord.gg/xJ2HRxZ
Project-URL: Source, https://github.com/Soheab/vacefron.py
Project-URL: Documentation, https://github.com/Soheab/vacefron.py/blob/master/docs.md
Project-URL: Issue tracker, https://github.com/Soheab/vacefron.py/issues
Keywords: vacefron,discord,api
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: aiohttp

[![PyPi Version](https://img.shields.io/pypi/v/vacefron.py.svg)](https://pypi.python.org/pypi/vacefron.py/)
[![Downloads](https://pepy.tech/badge/vacefron-py)](https://pepy.tech/project/vacefron-py)
[![MIT License](https://img.shields.io/apm/l/atomic-design-ui.svg?)](https://github.com/tterb/atomic-design-ui/blob/master/LICENSEs)

# VACEfron.py
A Wrapper for [vacefron.nl/api](https://vacefron.nl/api/) written in Python.


# Requirements
- Python 3.6 or above
- aiohttp (python3 -m pip install -U aiohttp)

# Documentation
See the full and detailed [docs here](https://github.com/Soheab/vacefron.py/blob/master/docs.md)

# Installation
Install the package by doing one of the following commands:

##### Using pip (recommended):
- pip install vacefron.py -U
- python -m pip install vacefron.py -U

# Changelog
See the changelog for each [version here](https://github.com/Soheab/vacefron.py/blob/master/changelog.md)

# Examples

Generate a [Rank card](docs.md#rank-card) with [discord.py](https://github.com/Rapptz/discord.py):
```python
import vacefron
import json
import discord

from discord.ext import commands

bot = commands.Bot(command_prefix="!")
vac_api = vacefron.Client()

@bot.command()
async def rank(ctx):
    with open("ranks.json") as f:
        ranks = json.load(f)

    info = ranks[str(ctx.author.id)]
    boosting = True if ctx.author.premium_since else False
    gen_card = await vac_api.rank_card(
        username = ctx.author,
        avatar = ctx.author.avatar_url,
        level = int(info['level']),
        rank = int(info['rank']),
        current_xp = int(info['current_xp']),
        next_level_xp = 500,
        previous_level_xp = 50,
        is_boosting = boosting
        )
    rank_image = discord.File(fp = await gen_card.read(), filename = f"{ctx.author}_rank.png")
    await ctx.send(f"{ctx.author.name}'s rank in {ctx.guild.name}", file = rank_image)

# is_boosting, custom_background and xp_color are optional, see more in the docs.
```

[I can milk you meme](docs.md#await-vac_apii_can_milk_youuser-user2) with [discord.py](https://github.com/Rapptz/discord.py):
```python
import vacefron
import discord
from discord.ext import commands

bot = commands.Bot(command_prefix="!")
vac_api = vacefron.Client()

@bot.command()
async def icanmilkyou(ctx, face: discord.Member, cow: discord.Member):
    meme = await vac_api.i_can_milk_you(face.avatar_url, cow.avatar_url)
    meme_image = discord.File(fp = await meme.read(), filename = "let_me_milk_you.png")
    await ctx.send(file=meme_image)
```

# Made by

This wrapper is made by **Soheab#6240**, DM me on Discord or [join my Server](https://discord.gg/yCzcfju) for anything 
related to this wrapper.

You can join VAC Efron's [server here](https://discord.gg/xJ2HRxZ) to suggests something for the API.


