Skip to main content

An asynchronous wrapper for the discord.bio api

Project description

discordbio

An asynchronous Python wrapper for the discord.bio API

Installing

pip install discordbio

Usage

  • Setting up the client

This will be used to make requests to the API

from discordbio import DBioClient

client = DBioClient()
  • Exceptions
Error Description
discordbio.errors.BaseDBioException Exception others subclass from, can be used to catch any error thrown from the wrapper
discordbio.errors.DBioError Raised when discord.bio doesn't return a successful response
discordbio.errors.HTTPException Raised when the request to discord.bio itself fails
  • Getting a user's details, via username or Discord ID

All methods of DBioClient are typed meaning your IDE should auto complete the attributes If not, you can import the types (UserDetails and UserConnections) and manually set the type

details = await client.details("geek")
# With Type
from discordbio import UserDetails

details: UserDetails = await client.details("geek")
  • Getting a specific value from a user's details, e.g. description
description = (await client.details("geek")).settings.description
  • Getting a user's connections
connections = await client.connections("geek")

# With Discord connections
connections = await client.connections("geek", with_discord=True)
# With Type
from discordbio import UserConnections


connections: UserConnections = await client.connections("geek", with_discord=True)
  • Miscellaneous Endpoints
users = await client.total_users()  # Returns total user count
from discordbio import PartialUser
from typing import List


upvoted: List[PartialUser] = await client.top_upvoted() 

Attributes

  • UserDetails (from client.details)
settings: Settings
discord: Discord
  • Settings
user_id: int
name: str
status: Optional[str]
description: Optional[str]
verified: bool
upvotes: int
premium: bool
location: Optional[str]
gender: Optional[str]
birthday: Optional[datetime]
email: Optional[str]
occupation: Optional[str]
created_at: datetime
banner: Optional[str]
  • Discord
id: int
username: str
avatar: Optional[str]
avatar_url: str
is_avatar_animated: bool
discriminator: str
  • Partial User (from client.top_upvoted)
user_id: int
name: str
description: Optional[str]
verified: bool
upvotes: int
premium: bool
discord: Discord
  • Connections (from client.connections)
github: Optional[str]
website: Optional[str]
instagram: Optional[str]
snapchat: Optional[str]
linkedin: Optional[str]
discord: List[DiscordConnection]
  • Discord Connections
connection_type: str
name: str
url: str

Project details


Download files

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

Files for discordbio, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size discordbio-1.2.0-py3-none-any.whl (10.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size discordbio-1.2.0.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page