aiwolf-nlp-common 0.5.0

aiwolf-nlp-common

aiwolf-nlp-common

人狼知能コンテスト（自然言語部門） のエージェント向けの共通パッケージです。
ゲームサーバから送信されるJSON形式のデータをオブジェクトに変換するためのパッケージです。

import json

from aiwolf_nlp_common.packet import Packet

value = """{"request":"INITIALIZE","info":{"day":0,"agent":"Agent[01]","statusMap":{"Agent[01]":"ALIVE","Agent[02]":"ALIVE","Agent[03]":"ALIVE","Agent[04]":"ALIVE","Agent[05]":"ALIVE"},"roleMap":{"Agent[01]":"WEREWOLF"}},"setting":{"playerNum":5,"maxTalk":5,"maxTalkTurn":20,"maxWhisper":5,"maxWhisperTurn":20,"maxSkip":0,"isEnableNoAttack":false,"isVoteVisible":false,"isTalkOnFirstDay":true,"responseTimeout":120000,"actionTimeout":60000,"maxRevote":1,"maxAttackRevote":1,"roleNumMap":{"BODYGUARD":0,"MEDIUM":0,"POSSESSED":1,"SEER":1,"VILLAGER":2,"WEREWOLF":1}}}"""
packet = Packet.from_dict(json.loads(value))

print(packet.request) # Request.INITIALIZE
print(packet.info.agent) # Agent[01]

詳細については下記のプロトコルの説明やゲームサーバのソースコードを参考にしてください。
プロトコルの実装について

インストール方法

python -m pip install aiwolf-nlp-common

運営向け

パッケージ管理ツールとしてuvの使用を推奨します。

git clone https://github.com/kano-lab/aiwolf-nlp-common.git
cd aiwolf-nlp-common
uv venv
uv sync

パッケージのビルド

uv build

パッケージの配布

PyPI

uv publish --token <PyPIのアクセストークン>

TestPyPI

uv publish --publish-url https://test.pypi.org/legacy/ --token <TestPyPIのアクセストークン>

uvを使用しない場合については、パッケージ化と配布については下記のページを参考にしてください。
Packaging and distributing projects