Descargar dsc.py - Descargar el código fuente dsc.py

dsc.py

Código Fuente de IA

1.0.0

Descargar

dsc.py

Un envoltorio simple y fácil de usar totalmente asincrónico para la API DSC.GG.

Instalación

pip install dsc.py

Uso

A continuación puede encontrar el uso de ejemplo de todos los métodos de esta biblioteca y la inicialización del cliente.
Para referencia con respecto a los objetos devueltos por la biblioteca, consulte esto

Inicializar el cliente

 import dsc

client = dsc . Client ( key = 'YOUR_API_KEY' )

Obtener un usuario

 user = await client . get_user ( USER_ID )

print ( f"This user joined dsc.gg on { user . created_at } " )

Obtener un enlace

 link = await client . get_link ( 'link' )  # Can be either a slug or a full URL

print ( f"This link owner's ID is: { link . owner_id } , and it leads to { link . redirect } " )

Obtener una aplicación

 app = await client . get_app ( APP_ID )

print ( f"This app's owner's ID is { app . owner_id } and it was created at { app . created_at } " )

Obtener enlaces superiores

 links = await client . get_top_links ()

print ( links [ 1 ]. id )

Obtenga los enlaces de un usuario (solo la lista blanca)

 links = await client . get_user_links ( USER_ID )

print ( links [ 0 ]. redirect )

Obtenga las aplicaciones de un usuario (solo la lista blanca)

 apps = await client . get_user_apps ( USER_ID )

print ( any ([ app . verified for app in apps ]))  # check if the user has any verified apps

Búsqueda (solo la lista blanca)

 links = await client . search ( 'search_query' , limit = 50 )  # optional limit

print ( len ( links ))

Crea un enlace

Puede ser elegante con este y crear una incrustación para usar con el enlace, ver a continuación. Tenga en cuenta que el color no funcionará, al crear, solo al actualizar un enlace.

Crear una incrustación

 embed = dsc . Embed (
    color = dsc . Color . red (),
    title = 'Embed title' ,
    image = 'image url' ,
    description = 'Embed description'
)

¡Cualquier cosa que no sea la babosa y la redirección es opcional! constructor.

 res = await client . create_link ( 'link slug' , 'redirect' , embed = embed )

if res . status == 200 :
    print ( 'Link created!' )
else :
    print ( 'An error occurred.' )

Actualizar un enlace

Similar a la creación, excepto que la babosa del enlace debe ser un enlace existente, no hay necesidad de pasar type .
No pasar algunos argumentos a la incrustación dará como resultado actualizar solo estos campos y dejar otros como son.

 updated_embed = dsc . Embed ( color = dsc . Color . red ())
await client . update_link ( 'link slug' , password = 'youshallnotpass' , unlisted = True , embed = updated_embed )

Eliminar un enlace

 await client . delete_link ( 'link slug' )

Objetos

DSC.PY incluye 4 objetos: usuario, enlace, incrustación y color. Cada atributo del objeto aparecerá en la lista, los valores de fecha y hora están en UTC.

Aplicación

Atributos

ID: int
propietario_id: int
Verificado: bool
creado_at: datetime
Clave: Optional[str] (presente solo si es dueño de la aplicación)

Métodos

to_dict() - Devuelva el objeto en forma de diccionario

Usuario

Atributos

ID: int
Premium: bool
Verificado: bool
unido_at: datetime
Personal: bool

Métodos

to_dict() - Devuelva el objeto en forma de diccionario

Enlace

Atributos

ID: str
Redirección: str
propietario_id: int
incrustación: dsc.Embed (ver el objeto a continuación)
Editores: List[int]
creado_at: datetime
Tipo: str ('bot', 'servidor', 'plantilla' o 'enlace')
no señión: str
Desactivado: bool
BUMPED_AT: datetime
Dominio: str

Métodos

to_dict() - Devuelva el objeto en forma de diccionario

Empotrar

Devuelto en respuestas o del usuario creado, las incrustaciones son una forma de hacer que sus enlaces se destaquen.

Atributos

Color: dsc.Color (ver el objeto a continuación)
Título: str
Descripción: str
Imagen str (URL de imagen)

Métodos

to_dict() - Devuelva el objeto en forma de diccionario

Métodos de clase

from_dict(data: dict) : devuelva un objeto de incrustación inicializado con valores del diccionario

Color

Esto es extremadamente similar al color de Discord.py, aunque también permite pasar cadenas.
Todos los métodos de clase de color incorporados Discord.py también están aquí, Ex. dsc.Color.red()