maimai.py (文档)
用于国服舞萌相关开发的最佳Python工具库, 封装水鱼/落雪查分器常用函数.
提供了基于日服舞萌标准的数据模型和接口, 为水鱼和落雪分别做了数据源实现.
支持从数据源查询歌曲、谱面、玩家信息、分数、Rating、姓名框、牌子进度.
另外, 支持联动微信 OpenID 获取玩家分数, 解析分数HTML, 并上传至数据源.
使用方式
pip install maimai-py
升级方式:
pip install -U maimai-py
另外, 您也可以下载 maimai.py 客户端, 使用任何编程语言进行开发.
快速开始
import asyncio
from maimai_py import MaimaiClient, MaimaiPlates, MaimaiScores, MaimaiSongs, PlayerIdentifier, DivingFishProvider
# 全局创建 MaimaiClient 实例
maimai = MaimaiClient()
divingfish = DivingFishProvider(developer_token="your_token_here")
async def quick_start():
# 获取所有歌曲及其元数据
songs: MaimaiSongs = await maimai.songs()
# 获取水鱼查分器用户 turou 的分数
scores: MaimaiScores = await maimai.scores(PlayerIdentifier(username="turou"), provider=divingfish)
# 获取水鱼查分器用户 turou 的舞将牌子信息
plates: MaimaiPlates = await maimai.plates(PlayerIdentifier(username="turou"), "舞将", provider=divingfish)
song = await songs.by_id(1231) # 生命不詳 by 蜂屋ななし
print(f"歌曲 1231 是: {song.artist} - {song.title}")
print(f"TuRou 的 Rating 为: {scores.rating}, b15 中最高 Rating 为: {scores.scores_b15[0].dx_rating}")
print(f"TuRou 的 舞将 完成度: {await plates.count_cleared()}/{await plates.count_all()}")
asyncio.run(quick_start())
更多内容请查看文档: https://maimai.turou.fun/.
异步
maimai.py 默认采用全异步, 且暂时没有提供同步方法和接口的计划.
如果您不希望采用异步, 可以使用 asyncio.run 包裹方法, 将异步方法同步调用.
客户端
maimai.py 提供了 RESTful API 客户端, 您可以通过任何语言通过HTTP请求来调用 maimai.py 的特性.
客户端使用 Nuitka 编译, 请在 Releases 页面下载.
我们的客户端支持 Windows, Linux, 请根据您的系统下载对应的版本.
客户端 Swagger 文档请查看: https://openapi.maimai.turou.fun/.
贡献
如果您想要贡献代码, 请阅读 CONTRIBUTING.md
1 maintainer
Metadata
1 maintainer
Release files for maimai-py 1.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| maimai_py-1.5.2.tar.gz | 303.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| maimai_py-1.5.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 620.5 kB
Release files / maimai_py-1.5.2.tar.gz
| Download URL | maimai_py-1.5.2.tar.gz |
|---|---|
| Size | 303.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40209df090c3a2a39f61290568760799a4b7e73b0092f142d3ba0714b7538db0
|
|
BLAKE2b-256 checksum How to use checksums |
4b346a4397af76e8f5bddd0fb7c9148672fdb2ddbd8cfeb809b41c194946e63c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.14 Linux/6.17.0-1022-azure
|
Release files / maimai_py-1.5.2-py3-none-any.whl
| Download URL | maimai_py-1.5.2-py3-none-any.whl |
|---|---|
| Size | 316.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e8f9f39a5c8013c65fef0be4515b34c49a77f95090b7b11d8f89b22e9b709c88
|
|
BLAKE2b-256 checksum How to use checksums |
c5c038d3095eaa5bacfc0c591be6bfd3520dca80d3e08f6a62226584a2fabfb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.14 Linux/6.17.0-1022-azure
|
