From b67ebf6f252f4a071973a34abba5967b9b6c9179 Mon Sep 17 00:00:00 2001 From: usbharu <64310155+usbharu@users.noreply.github.com> Date: Fri, 17 Feb 2023 16:35:34 +0900 Subject: [PATCH] =?UTF-8?q?feat:=20README.md=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..925c427 --- /dev/null +++ b/README.md @@ -0,0 +1,70 @@ + +# MultiM: Misskey/Mastodon API Client (in development) + +[![test in gradle](https://github.com/usbharu/multim/actions/workflows/pr-test.yml/badge.svg)](https://github.com/usbharu/multim/actions/workflows/pr-test.yml) + +## これは何? What is this? + +Misskey/MastodonのAPIを可能な限り抽象化し、クライアント/Botの開発を簡単にするために作成された、APIクライアントです。99% Kotlinで作成されており、JVM/Android上で動作します。現在Misskey v12にのみ対応しています。あと名前募集しています。 + +## 使い方 How to use. + +Mavenリポジトリに登録されていないため手動でビルドする必要があります。また、開発中のため使用できない機能があります。 + +### リポジトリ任意の場所にをクローン + +使用するプロジェクトとは別の場所に作成してください。 + +`git clone https://github.com/usbharu/multim.git` + +### Maven Localに公開 + +`gradlew publishToMavenLocal` + +### 使用するリポジトリに追加 + +```groovy +repositories { + mavenLocal() +} + +dependencies{ + implementation("dev.usbharu:multim-core:$multim_version") + implementation("dev.usbharu:multim-misskey:$multim_version") + implementation("dev.usbharu:multim-mastodon:$multim_version") +} +``` +### 実行 + +```kotlin +val client = MultiM.createClient( + "https://url-to-mastodon-or-misskey-url/", + "token", + ServiceInfoFactory(listOf(MisskeyV12Info)) +) + +client.statusApi.findById(MisskeyStatusId("id","url-to-note")) //←改良予定 +``` +すべての共通APIは [core/src/main/kotlin/dev/usbharu/multim/api](https://github.com/usbharu/multim/tree/develop/core/src/main/kotlin/dev/usbharu/multim/api) にあります。 + +## 今後の実装予定 + +- Mastodon対応 +- Misskey v13対応 +- Fedibird対応 +- キャッシュ +- + +## 感謝 Thanks for + +### GitHub name +- yude Misskey・Mastodonを1から色々教えてくれた。 +- pantasystem Android・Misskey APIを教えてくれた。Fedibird招待してくれた。 + +### Library name +- ktor +- kotlinx-serialization +- kotlinx-datetime +- kotlinx-coroutines +- napier +- kotlin-result