Skip to main content

Discord API wrapper rebuild from scratch.

Project description

Pincer

Scrutinizer Code Quality Build Status GitHub repo size GitHub last commit GitHub commit activity GitHub Code Style Discord

An asynchronous Python API wrapper meant to replace discord.py

The package is currently within the planning phase

📌 Links

Join the Discord server: https://discord.gg/8WkYz3fNFm
The PyPI package: https://pypi.org/project/Pincer
Our website: https://pincer.dev
ReadTheDoc: https://pincer.readthedocs.io

☄️ Installation

Use the following command to install Pincer into your Python environment:

pip install pincer
⚙️ Didn't work?

Depending on your Python installation, you might need to use one of the following:

  • Python is not in PATH

    path/to/python.exe -m pip install pincer
    
  • Python is in PATH but pip is not

    python -m pip install pincer
    
  • Unix systems can use pip3/python3 commands

    pip3 install pincer
    
    python3 -m pip install pincer
    
  • Using multiple Python versions

    py -m pip install pincer
    

Current Features

  • Dispatcher
  • Logging
  • HTTP Client
  • Client base class
  • Basic events

The documentation has been improved!

Client base class example:

from pincer.client import Bot

# Note that both `Bot` and `Client` are valid!
bot = Bot("...")
bot.run()

An example on the on_ready event

from time import perf_counter
from pincer.client import Client

client = Client("...")


@client.event
async def on_ready():
    print(f"Logged in as {client.bot} after {perf_counter()} seconds")


client.run()

Inherited client

You have the possibility to use your own class to inherit from the Pincer bot base.

class Bot(Client):

    def __init__(self) -> None:
        super(Bot, self).__init__(token='...')

    @Client.event
    async def on_ready(self) -> None:
        ...

See an advanced bot implementation:

https://github.com/Pincer-org/Pincer-bot

Advanced Usage

Warning: These features are meant for advanced developers to make early experimentation with Pincer.

Enable the debug mode

If you want to see everything that is happening under the hood, either out of curiosity or to get a deeper insight into the implementation of some features, we provide debug logging!

import logging

logging.basicConfig(level=logging.DEBUG)

Note: A lot of printing can happen, including sensitive information, so make sure to be aware of what you're doing if you're enabling it!

Middleware

Within the version 0.4.0-dev, the middleware system has been re-created, and now advanced users can utilize them; however, it should be done carefully.

A /say command early implementation using middleware

https://gist.github.com/Arthurdw/e110ebbdafca388722f25ddb79c1dfb8

.5.x verions

The 0.5.x version don't add any new features, but implement the discordpy classes within the package. Those will be very useful for the next versions

Classes

APIObject, Application commands, Application, Attachement, AuditLog, Ban, Button, Channel, ChannelMention, Emoji, FollowedChannels, GuidMember, Guild, GuildWidget, Interactions, Invite, Member, Message, MessageReference, Overwrite, Reaction, Role, Select Menu, Select Option StageInstance, Sticker, StickerItem, StickerPack, Thread, User, VoiceRegion, VoiceState, Webhook, WelcomeScreen,

🏷️ License

© 2021 copyright Pincer

This repository is licensed under the MIT License.

See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pincer-0.6.1.dev0-py3-none-any.whl (94.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page