download dsc.py - dsc.py download de código fonte

dsc.py

Código-Fonte de IA

1.0.0

Baixar

dsc.py

Um invólucro simples e fácil de usar e totalmente assíncrono para a API DSC.GG.

Instalação

pip install dsc.py

Uso

Abaixo, você pode encontrar um exemplo de uso de todos os métodos desta biblioteca e inicialização do cliente.
Para referência sobre objetos retornados pela biblioteca, consulte isso

Inicializar o cliente

 import dsc

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

Obtenha um usuário

 user = await client . get_user ( USER_ID )

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

Obtenha um link

 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 } " )

Obtenha um aplicativo

 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 } " )

Obtenha os principais links

 links = await client . get_top_links ()

print ( links [ 1 ]. id )

Obtenha os links de um usuário (apenas a lista de permissões)

 links = await client . get_user_links ( USER_ID )

print ( links [ 0 ]. redirect )

Obtenha os aplicativos de um usuário (apenas na lista de permissões)

 apps = await client . get_user_apps ( USER_ID )

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

Pesquisa (apenas na lista de permissões)

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

print ( len ( links ))

Crie um link

Você pode se buscar com este e criar uma incorporação para usar com o link, veja abaixo. Observe que a cor não funcionará, ao criar, apenas ao atualizar um link.

Crie uma incorporação

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

Qualquer coisa que não seja a lesma e o redirecionamento é opcional! construtor.

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

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

Atualize um link

Semelhante à criação, exceto que a lesma do link deve ser um link existente, não há necessidade de passar type .
Não passar alguns argumentos para a incorporação resultará na atualização apenas desses campos e na saída de outros como eles.

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

Exclua um link

 await client . delete_link ( 'link slug' )

Objetos

O dsc.py inclui 4 objetos - usuário, link, incorporação e cor. Todo atributo do objeto será listado, os valores do DateTime estão no UTC.

App

Atributos

id: int
proprietário_id: int
Verificado: bool
Criado_at: datetime
Chave: Optional[str] (presente apenas se você possui o aplicativo)

Métodos

to_dict() - Retorne o objeto na forma de um dicionário

Usuário

Atributos

id: int
Premium: bool
Verificado: bool
juntou -se: datetime
Pessoal: bool

Métodos

to_dict() - Retorne o objeto na forma de um dicionário

Link

Atributos

Id: str
Redirecionar: str
proprietário_id: int
Incorporar: dsc.Embed (veja o objeto abaixo)
Editores: List[int]
Criado_at: datetime
Tipo: str ('bot', 'servidor', 'modelo' ou 'link')
não listado: str
desativado: bool
Bumped_at: datetime
Domínio: str

Métodos

to_dict() - Retorne o objeto na forma de um dicionário

Incorporar

Devolvidos em respostas ou usuário criado, as incorporações são uma maneira de destacar seus links.

Atributos

Cor: dsc.Color (veja o objeto abaixo)
Título: str
Descrição: str
Image str (URL da imagem)

Métodos

to_dict() - Retorne o objeto na forma de um dicionário

Métodos de classe

from_dict(data: dict) - Retorne um objeto incorporado inicializado com valores do dicionário

Cor

Isso é extremamente semelhante à cor de discord.py, embora também permita passar strings.
Todos os métodos de classe de cores internos de discord.py também estão aqui, ex. dsc.Color.red()