4.0 KiB

Raw Blame History Unescape Escape

MiPAC

概要

MiPAのCoreとなるライブラリです。

MiPACはMisskey v11, 12, 13をサポートしているApi Wrapperです。本来気にしないといけないバージョンごとのAPIの違い等を吸収してくれます。

サポートしているMisskey

name	version	supported
Misskey Official	v13, v12, v11	〇
Ayuskey	v5, v6	〇

使い方

import asyncio

from mipac.client import Client

async def main():
    client = Client(url, token)
    await client.http.login()
    api = client.api
    note = await api.note.action.send('Hello World')
    print(note.author.name, note.content)

if __name__ == '__main__':
    asyncio.run(main())

注意事項

Python3.12.0 final がリリースされ、3カ月経過後に最低バージョンを 3.12.0 に変更します

これは主にMiPACの開発を行う上で、新規構文の使用などによってDXがより良くなり開発ペースが向上する為です。また、使用者の皆様においてはPythonの高速化や新規構文の使用などが使用できるといった恩恵を得ることができます。

現在Python3.12.0のリリースは以下のように記載されているため、早くて 2024年01月02日 に変更を実施する予定です。

3.12.0 final: Monday, 2023-10-02

これについて意見がある場合はDiscussionを作成することができます。

一部サーバー(インスタンス)のバージョンによっては正常に動作しない可能性があります

MiPACの特徴として、v11,v12,v13のバージョンごとに生じる変更点をなるべく気にしなくてよいように作成していますが、現状の最新版であるv13でもv13の中で削除されたり、増えたりした物があります。結果的に追従しきれていない箇所があることがあります。そのため、そのような物を見つけた場合は、使用しているサーバーのバージョンと使用できないエンドポイント名をIssueに送信してください。

モデルを自分でインスタンス化することは想定されていません

MiPACのモデルでは多くの場合、キーワード引数に clientを受け取り、それを用いてapi プロパティを生成します。しかし、サポート途中の機能なのではそこが省かれ、リリース後にモデルのインスタンス化に必要な引数として client が追加されることがあります。また、他にもモデルの更新のために引数が変更される可能性があります。そのため、引数の変更に関することをCHANGELOG等で通知することはありません。

LICENSE

MiPAC is provided with MIT LICENSE.

Documentation * Discord Server

4.0 KiB Raw Blame History Unescape Escape