dsc.py Download - dsc.py Sumber Code Download

dsc.py

Kode Sumber AI

1.0.0

Unduh

dsc.py

Pembungkus yang sederhana dan mudah digunakan, sepenuhnya asinkron untuk API DSC.GG.

Instalasi

pip install dsc.py

Penggunaan

Di bawah ini Anda dapat menemukan contoh penggunaan semua metode perpustakaan dan inisialisasi klien ini.
Untuk referensi mengenai objek yang dikembalikan oleh perpustakaan, lihat ini

Inisialisasi klien

 import dsc

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

Dapatkan pengguna

 user = await client . get_user ( USER_ID )

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

Dapatkan tautan

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

Dapatkan aplikasi

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

Dapatkan tautan teratas

 links = await client . get_top_links ()

print ( links [ 1 ]. id )

Dapatkan tautan pengguna (hanya daftar putih)

 links = await client . get_user_links ( USER_ID )

print ( links [ 0 ]. redirect )

Dapatkan aplikasi pengguna (hanya daftar putih)

 apps = await client . get_user_apps ( USER_ID )

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

Cari (hanya daftar putih)

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

print ( len ( links ))

Buat tautan

Anda bisa mewah dengan yang ini, dan membuat embed untuk digunakan dengan tautan, lihat di bawah. Harap dicatat bahwa warnanya tidak akan berfungsi, saat membuat, hanya saat memperbarui tautan.

Buat embed

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

Apa pun selain siput dan pengalihan adalah opsional! konstruktor.

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

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

Perbarui tautan

Mirip dengan pembuatan, kecuali tautan siput harus menjadi tautan yang ada, tidak perlu meneruskan type .
Tidak menyerahkan beberapa argumen ke dalam sematan akan menghasilkan hanya memperbarui bidang -bidang ini dan meninggalkan yang lain sebagaimana adanya.

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

Hapus tautan

 await client . delete_link ( 'link slug' )

Objek

dsc.py mencakup 4 objek - pengguna, tautan, embed dan warna. Setiap atribut objek akan terdaftar, nilai datetime ada di UTC.

Aplikasi

Atribut

ID: int
Owner_id: int
Diverifikasi: bool
create_at: datetime
Kunci: Optional[str] (hanya ada jika Anda memiliki aplikasi)

Metode

to_dict() - mengembalikan objek dalam bentuk kamus

Pengguna

Atribut

ID: int
Premium: bool
Diverifikasi: bool
goined_at: datetime
Staf: bool

Metode

to_dict() - mengembalikan objek dalam bentuk kamus

Link

Atribut

ID: str
Redirect: str
Owner_id: int
Embed: dsc.Embed (lihat objek di bawah)
Editor: List[int]
create_at: datetime
Jenis: str ('bot', 'server', 'template' atau 'link')
tidak terdaftar: str
Dinonaktifkan: bool
bumped_at: datetime
Domain: str

Metode

to_dict() - mengembalikan objek dalam bentuk kamus

Menanamkan

Dikembalikan dalam tanggapan atau pengguna yang dibuat, embeds adalah cara untuk membuat tautan Anda menonjol.

Atribut

Warna: dsc.Color (lihat objek di bawah)
Judul: str
Deskripsi: str
gambar str (URL gambar)

Metode

to_dict() - mengembalikan objek dalam bentuk kamus

Metode kelas

from_dict(data: dict) - mengembalikan objek embed yang diinisialisasi dengan nilai -nilai dari kamus

Warna

Ini sangat mirip dengan warna Discord.py, meskipun memungkinkan string yang lewat juga.
Semua-metode kelas warna Discord.py juga ada di sini, Kel. dsc.Color.red()