Metadata-Version: 2.4
Name: toetactic
Version: 0.10.2
Summary: Play Tic Tac Toe in the terminal
License: Apache-2.0
License-File: LICENSE
Keywords: toetactic,tic-tac-toe,cli,game
Author: Little Godzilla Laboratory
Author-email: blah+lgl@cliffano.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click (>=8.3.3,<8.4.0)
Requires-Dist: conflog (>=2.1.1,<2.2.0)
Project-URL: Documentation, https://github.com/littlegodzillalaboratory/toetactic
Project-URL: Homepage, https://github.com/littlegodzillalaboratory/toetactic
Project-URL: Repository, https://github.com/littlegodzillalaboratory/toetactic
Description-Content-Type: text/markdown

<!-- BEGIN:AVATAR -->
![Avatar](avatar.jpg)
<!-- END:AVATAR -->

<!-- BEGIN:BADGES -->
[![Build Status](https://github.com/littlegodzillalaboratory/toetactic/workflows/CI/badge.svg)](https://github.com/littlegodzillalaboratory/toetactic/actions?query=workflow%3ACI)
[![Code Scanning Status](https://github.com/littlegodzillalaboratory/toetactic/workflows/CodeQL/badge.svg)](https://github.com/littlegodzillalaboratory/toetactic/actions?query=workflow%3ACodeQL)
[![Dependencies Status](https://img.shields.io/librariesio/release/pypi/toetactic)](https://libraries.io/github/littlegodzillalaboratory/toetactic)
[![Security Status](https://snyk.io/test/github/littlegodzillalaboratory/toetactic/badge.svg)](https://snyk.io/test/github/littlegodzillalaboratory/toetactic)
[![Published Version](https://img.shields.io/pypi/v/toetactic.svg)](https://pypi.python.org/pypi/toetactic)
<!-- END:BADGES -->

# Toetactic

A terminal Tic Tac Toe game where you can battle four AI opponents:

* Dikembe: purely defensive, focused on blocking your lines.
* Godzilla: aggressive, always looking for direct winning opportunities.
* Noober: picks any legal move at random, hoping for luck.
* Eleanor: builds rows and columns, avoiding diagonals unless it has no other legal move.

![Toetactic Board Screenshot](screenshots/board.png)

## Installation

```shell
pip3 install toetactic
```

## Usage

Run the game:

```shell
toetactic
```

The game will prompt you for:

1. Board dimension (default: 3)
2. Your player name
3. Opponent (`dikembe`, `godzilla`, `noober`, or `eleanor`)

Then enter your moves using chess-like coordinates such as `A1`, `B3`, `C2`.

Show help guide:

```shell
toetactic --help
```

## Colophon

<!-- BEGIN:DEVELOPERS_GUIDE -->
[Developer's Guide](https://littlegodzillalaboratory.github.io/developers-guide-python.html)
<!-- END:DEVELOPERS_GUIDE -->

<!-- BEGIN:BUILD_REPORTS -->
Build reports:

* [Lint report](https://littlegodzillalaboratory.github.io/toetactic/lint/pylint/index.html)
* [Code complexity report](https://littlegodzillalaboratory.github.io/toetactic/complexity/radon/index.html)
* [Unit tests report](https://littlegodzillalaboratory.github.io/toetactic/test/pytest/index.html)
* [Test coverage report](https://littlegodzillalaboratory.github.io/toetactic/coverage/coverage/index.html)
* [Integration tests report](https://littlegodzillalaboratory.github.io/toetactic/test-integration/pytest/index.html)
* [API Documentation](https://littlegodzillalaboratory.github.io/toetactic/doc/sphinx/index.html)

<!-- END:BUILD_REPORTS -->

