Metadata-Version: 2.4
Name: quartors
Version: 0.1.0
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Rust
Classifier: Topic :: Games/Entertainment :: Board Games
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Dist: numpy>=2.1.3
License-File: LICENSE
Summary: Quarto game engine, search, self-play, arena, and dataset tooling.
Keywords: board-game,mcts,quarto,reinforcement-learning,self-play
Author-email: niart120 <38847256+niart120@users.noreply.github.com>
Maintainer-email: niart120 <38847256+niart120@users.noreply.github.com>
License-Expression: MIT
Requires-Python: >=3.13
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://github.com/niart120/quartors#readme
Project-URL: Issues, https://github.com/niart120/quartors/issues
Project-URL: Repository, https://github.com/niart120/quartors

# quartors

`quartors` は、Quarto のゲーム処理、探索、自己対戦、評価対局、学習データ処理を Rust で実装し、PyO3 を介して Python から利用するためのライブラリです。

`0.1.0` release candidate の実装と配布 workflow を収録しています。公開 API と完了条件は [`spec/initial/roadmap.md`](spec/initial/roadmap.md)、実際の TestPyPI/PyPI 公開操作は [公開手順](spec/publishing.md) を参照してください。

ゲーム状態、探索、自己対戦、評価対局、versioned dataset は、Python の top-level API から利用できます。release matrix は Python 3.13/3.14 と Linux、macOS、Windows を対象とします。wheel-only consumer acceptance、sdist 再 build、型情報、CycloneDX SBOM、format v1 fixture の検証を release workflow で行います。

```python
import quartors

state = quartors.State.initial()
state = state.apply(5).apply(6)
assert state.board[6] == 5
assert state.observation().shape == quartors.OBSERVATION_SHAPE
```

## 仕様

- [ゲーム規則](spec/initial/rules.md)
- [公開 API](spec/initial/api.md)
- [アーキテクチャ](spec/initial/architecture.md)
- [実装ロードマップ](spec/initial/roadmap.md)
- [変更履歴](CHANGELOG.md)
- [公開手順](spec/publishing.md)

ライセンスは [MIT License](LICENSE) です。

## 開発環境

Rust stable と [uv](https://docs.astral.sh/uv/) を使用します。Python 3.13 のロック済み開発環境を作成し、ネイティブ拡張を導入する手順は次のとおりです。

```powershell
uv sync --locked --dev
uv run maturin develop --locked
uv run python -c "import quartors; print(quartors.__version__)"
```

品質ゲートと変更手順は [CONTRIBUTING.md](CONTRIBUTING.md) に記載しています。

