dsc.py

dsc.py

DSC.gg APIのシンプルで使いやすく、完全に非同期ラッパー。

インストール

pip install dsc.py

使用法

以下に、このライブラリのメソッドのすべての使用とクライアントの初期化を使用できます。
ライブラリが返品したオブジェクトに関する参照については、これをチェックしてください

クライアントを初期化します

 import dsc

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

ユーザーを取得します

 user = await client . get_user ( USER_ID )

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

リンクを取得します

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

アプリを入手してください

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

トップリンクを取得します

 links = await client . get_top_links ()

print ( links [ 1 ]. id )

ユーザーのリンクを取得する（ホワイトリストのみ）

 links = await client . get_user_links ( USER_ID )

print ( links [ 0 ]. redirect )

ユーザーのアプリを入手してください（ホワイトリストのみ）

 apps = await client . get_user_apps ( USER_ID )

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

検索（ホワイトリストのみ）

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

print ( len ( links ))

リンクを作成します

これで空想を得ることができ、リンクで使用する埋め込みを作成します。以下を参照してください。リンクを更新するときにのみ、作成するときに色が機能しないことに注意してください。

埋め込みを作成します

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

---

スラッグとリダイレクト以外はオプションです！コンストラクタ。

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

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

リンクを更新します

作成と同様に、リンクスラッグが既存のリンクである必要があることを除いて、 typeを渡す必要はありません。
いくつかの引数を埋め込みに渡さないと、これらのフィールドのみが更新され、他のフィールドをそのまま残します。

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

リンクを削除します

 await client . delete_link ( 'link slug' )

オブジェクト

dsc.pyには、ユーザー、リンク、埋め込み、色の4つのオブジェクトが含まれています。オブジェクトのすべての属性がリストされ、DateTime値はUTCにあります。

---

アプリ

属性

• ID： int
• owner_id： int
• 確認済み： bool
• created_at： datetime
• キー： Optional[str] （アプリを所有している場合にのみ表示）

方法

• to_dict() - 辞書の形でオブジェクトを返します

ユーザー

属性

• ID： int
• プレミアム： bool
• 確認済み： bool
• foined_at： datetime
• スタッフ： bool

方法

• to_dict() - 辞書の形でオブジェクトを返します

---

リンク

属性

• ID： str
• リダイレクト： str
• owner_id： int
• 埋め込み： dsc.Embed （以下のオブジェクトを参照）
• 編集者： List[int]
• created_at： datetime
• タイプ： str （ 'bot'、 'server'、 'テンプレート'、または「リンク」）
• 非公開： str
• 無効： bool
• Bumped_at： datetime
• ドメイン： str

方法

• to_dict() - 辞書の形でオブジェクトを返します

---

埋め込み

回答またはユーザーが作成して返されると、埋め込みはリンクを際立たせる方法です。

属性

• 色： dsc.Color （以下のオブジェクトを参照）
• タイトル： str
• 説明： str
• 画像str （画像URL）

方法

• to_dict() - 辞書の形でオブジェクトを返します

クラスメソッド

• from_dict(data: dict) - 辞書の値で初期化された埋め込みオブジェクトを返します

---

色

これはdiscord.pyの色に非常に似ていますが、文字列も通過することもできます。
すべてのdiscord.pyビルトインカラークラスメソッドもここにあります。 dsc.Color.red()

属性

• 値： int

方法

• to_dict() - 辞書の形でオブジェクトを返します

クラスメソッド

• Discord.pyのように

貢献

このパッケージはOpenSourceであるため、適切なPython体験をしている人なら誰でもこのプロジェクトに貢献できます！

報告の問題

パッケージにエラー/バグ/ミスが見つかった場合、またはコード内でお気軽に問題を作成して、ここで報告してください。

コンテンツを修正/編集します

このパッケージに貢献したい場合は、リポジトリをフォークし、変更を加えてから、プルリクエストを作成してください！

接触

あなたが私に連絡したいなら：
メール[email protected]
Discord wulf#9632