seks 0.1.0__tar.gz

seks-0.1.0/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-29
+
+### Added
+
+- First public release on PyPI, with a `seks` command to start the game.
+- Color themes, selected with `seks --theme NAME`: `felt` (the new default),
+  `classic` (the original colors), `wood`, `azulejo`, `paper`, `nord`,
+  `catppuccin-mocha`, `catppuccin-latte`, `dracula`, `gruvbox`, `solarized`,
+  `tokyo-night` and `rose-pine`.
+- Rules manual with screenshots in the README.
+- Test suite, linting, type checking and CI on GitHub Actions.
+
+### Fixed
+
+- A die now wins when it reaches the opponent's back row instead of its own.
+- A winning move now ends the game and shows the victory screen.
+- Clicking after a victory starts a new game.
+- Undoing a move that captured dice no longer crashes.
+- The victory screen no longer crashes when it is drawn.
+- Clicking a selected die that already shows 6 now cancels the selection.
+- Game sprites load from the installed package, not from the working directory.
+- Clicking the board margin no longer selects a die on the opposite edge, and
+  the first gutter pixel after a cell no longer counts as part of the cell.
+- A die on the board edge no longer captures dice on the opposite edge.
+- Undo gives the turn back to the player who made the play, also after a
+  winning move, and clears the current selection.
+- Loading a board (`Ctrl+L`) clears the undo history, and an invalid save file
+  is rejected with a warning instead of crashing the game.
+- The victory screen overlay stays inside the board and its banner is centered.
+- Save files also record whose turn it is, so loading a game restores the
+  player to move. Files that only contain the board are rejected.
+- Errors while reading or writing the save file are logged instead of closing
+  the game.
+- A player who cannot play (no dice left, or only blocked 6s) now loses,
+  instead of the game getting stuck.
+- Holding the undo button no longer undoes several plays in a row: presses
+  less than one second apart are ignored.
+
+### Changed
+
+- With a die selected, clicking another of your dice now selects it instead
+  of cancelling the selection.
+
+[Unreleased]: https://github.com/fabiommendes/seks/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/fabiommendes/seks/releases/tag/v0.1.0

seks-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fábio Macêdo Mendes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

seks-0.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: seks
+Version: 0.1.0
+Summary: Seks: an abstract strategy game played with dice on an 11x11 board.
+Keywords: game,board-game,abstract-strategy,dice,pyxel
+Author: Fábio Macêdo Mendes
+Author-email: Fábio Macêdo Mendes <fabiomacedomendes@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment :: Board Games
+Classifier: Typing :: Typed
+Requires-Dist: pyxel>=2.3
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/fabiommendes/seks
+Project-URL: Repository, https://github.com/fabiommendes/seks
+Project-URL: Issues, https://github.com/fabiommendes/seks/issues
+Project-URL: Changelog, https://github.com/fabiommendes/seks/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# Seks
+
+[![CI](https://github.com/fabiommendes/seks/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/fabiommendes/seks/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/seks.svg)](https://pypi.org/project/seks/)
+[![Python versions](https://img.shields.io/pypi/pyversions/seks.svg)](https://pypi.org/project/seks/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/fabiommendes/seks/blob/main/LICENSE)
+
+**Seks** is a two-player abstract strategy game played with dice on an 11×11
+board. Every die is a piece whose face tells how far it can travel. Moving
+spends that strength, so a player keeps choosing between advancing now and
+charging dice up for later. It is built with [Pyxel](https://github.com/kitao/pyxel).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/01-setup.png" width="320" alt="The initial position">
+</p>
+
+
+## Installation
+
+Seks needs Python 3.12 or newer. The easiest way to install the game is as a
+standalone tool:
+
+```bash
+uv tool install seks    # or: pipx install seks
+```
+
+A plain `pip install seks` works too.
+
+
+## Usage
+
+Start the game with:
+
+```bash
+seks
+```
+
+`python -m seks` does the same thing. To run it from a clone of this
+repository, use `uv run seks`.
+
+| Action                        | Control                                        |
+|-------------------------------|------------------------------------------------|
+| Select one of your dice       | Left click on it                               |
+| Move the selected die         | Left click on a highlighted cell               |
+| Increment the selected die    | Left click on it again                         |
+| Switch the selection          | Left click on another of your dice             |
+| Cancel the selection          | Left click anywhere else                       |
+| Undo the last play            | Click the ↺ button in a corner of the screen (at most once per second; holding it undoes a single play) |
+| Save / load the board         | `Ctrl+S` / `Ctrl+L` (uses `game.save` in the current directory) |
+| Start a new game after a win  | Left click anywhere                            |
+| Quit                          | `Esc`                                          |
+
+
+## Themes
+
+Pick a color theme with `--theme`:
+
+```bash
+seks --theme catppuccin-mocha
+```
+
+The default theme is `felt`, and `classic` has the original colors of the
+game. Run `seks --help` to list all themes.
+
+<table>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/felt.png" width="160" alt="felt theme"><br><code>felt</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/classic.png" width="160" alt="classic theme"><br><code>classic</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/wood.png" width="160" alt="wood theme"><br><code>wood</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/azulejo.png" width="160" alt="azulejo theme"><br><code>azulejo</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/paper.png" width="160" alt="paper theme"><br><code>paper</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/nord.png" width="160" alt="nord theme"><br><code>nord</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/catppuccin-mocha.png" width="160" alt="catppuccin-mocha theme"><br><code>catppuccin-mocha</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/catppuccin-latte.png" width="160" alt="catppuccin-latte theme"><br><code>catppuccin-latte</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/dracula.png" width="160" alt="dracula theme"><br><code>dracula</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/gruvbox.png" width="160" alt="gruvbox theme"><br><code>gruvbox</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/solarized.png" width="160" alt="solarized theme"><br><code>solarized</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/tokyo-night.png" width="160" alt="tokyo-night theme"><br><code>tokyo-night</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/rose-pine.png" width="160" alt="rose-pine theme"><br><code>rose-pine</code></td>
+  </tr>
+</table>
+
+
+## Rules
+
+### Setup
+
+The board has 11 columns and 11 rows. Each player starts with 16 dice:
+
+* 6 dice showing **1** on their back row, on every other cell;
+* 10 dice showing **2** on the row in front of it, which is full except for the
+  center column.
+
+White starts at the bottom of the screen and Black at the top. **White plays
+first**, and the players take turns after that.
+
+### Your turn
+
+On your turn, click one of your dice to select it, then do **exactly one** of
+the following.
+
+**1. Move.** A die moves in a straight line in any of the 8 directions
+(orthogonal or diagonal) by **at most as many cells as its value**. It cannot
+jump over other dice or land on an occupied cell. After the move, **the die
+shows the number of cells it traveled**: a 4 that moves 2 cells becomes a 2.
+
+When you select a die, every cell it can reach is highlighted, and the number
+shown on each cell is the value the die will have if it lands there. The
+selected die itself shows a preview of its incremented value (see below).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/02-select.png" width="300" alt="A selected die and its possible moves">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/04-move.png" width="300" alt="The die after moving three cells">
+</p>
+
+*Left: a white 2 is selected and can move one or two cells. Right: later on,
+a white 3 moved three cells forward and still shows 3.*
+
+**2. Increment.** Click the selected die again to add 1 to its value. This uses
+up your turn. A die can reach at most **6**. Clicking a selected 6 again only
+cancels the selection.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/03-increment.png" width="300" alt="A white die incremented from 2 to 3">
+</p>
+
+*White spent its first turn turning a 2 into a 3.*
+
+### Captures
+
+Captures are **custodial**: after you move a die, every enemy die that sits
+orthogonally next to the cell where it landed (up, down, left or right) and
+has one of your dice directly on its other side is captured and removed from
+the board.
+
+* A single move can capture in several directions at once.
+* Diagonal neighbors are never captured.
+* Only the player who moves captures: moving a die between two enemy dice is
+  safe.
+* Incrementing a die never captures.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/05-before-capture.png" width="300" alt="Before the capture">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/06-capture.png" width="300" alt="After the capture">
+</p>
+
+*The black 2 is flanked on its right by a white 3. White moves the other 3
+up to the left of the black die and captures it.*
+
+The counters on the left side of the screen show how many dice each player
+has lost. The top counter counts White's losses and the bottom one counts
+Black's.
+
+### Winning
+
+You win as soon as **one of your dice moves onto the opponent's back row**:
+the top row for White, the bottom row for Black.
+
+You also win when, after your play, **your opponent cannot play**: they have
+lost every die, or each of their dice is a 6 with no free cell to move to.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/07-before-victory.png" width="300" alt="A white 3 with a free path to the top row">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/08-victory.png" width="300" alt="White wins">
+</p>
+
+*The center column starts with a gap in the second row. This white 3 uses it
+to reach the top row and win.*
+
+
+## Development
+
+The project uses [uv](https://docs.astral.sh/uv/) and
+[taskipy](https://github.com/taskipy/taskipy):
+
+```bash
+git clone https://github.com/fabiommendes/seks.git
+cd seks
+uv sync
+uv run task --list
+```
+
+The main tasks are `task test`, `task lint`, `task docs`, `task ci` and
+`task release`. `task screenshots` plays a scripted game and regenerates the
+images in this README. See [CONTRIBUTING.md](https://github.com/fabiommendes/seks/blob/main/CONTRIBUTING.md)
+for details.
+
+
+## About the name
+
+*Seks* means "six" in Danish, Norwegian and Faroese, after the highest face of
+a die.
+
+
+## License
+
+Seks is released under the [MIT License](https://github.com/fabiommendes/seks/blob/main/LICENSE).

seks-0.1.0/README.md

@@ -0,0 +1,203 @@
+# Seks
+
+[![CI](https://github.com/fabiommendes/seks/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/fabiommendes/seks/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/seks.svg)](https://pypi.org/project/seks/)
+[![Python versions](https://img.shields.io/pypi/pyversions/seks.svg)](https://pypi.org/project/seks/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/fabiommendes/seks/blob/main/LICENSE)
+
+**Seks** is a two-player abstract strategy game played with dice on an 11×11
+board. Every die is a piece whose face tells how far it can travel. Moving
+spends that strength, so a player keeps choosing between advancing now and
+charging dice up for later. It is built with [Pyxel](https://github.com/kitao/pyxel).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/01-setup.png" width="320" alt="The initial position">
+</p>
+
+
+## Installation
+
+Seks needs Python 3.12 or newer. The easiest way to install the game is as a
+standalone tool:
+
+```bash
+uv tool install seks    # or: pipx install seks
+```
+
+A plain `pip install seks` works too.
+
+
+## Usage
+
+Start the game with:
+
+```bash
+seks
+```
+
+`python -m seks` does the same thing. To run it from a clone of this
+repository, use `uv run seks`.
+
+| Action                        | Control                                        |
+|-------------------------------|------------------------------------------------|
+| Select one of your dice       | Left click on it                               |
+| Move the selected die         | Left click on a highlighted cell               |
+| Increment the selected die    | Left click on it again                         |
+| Switch the selection          | Left click on another of your dice             |
+| Cancel the selection          | Left click anywhere else                       |
+| Undo the last play            | Click the ↺ button in a corner of the screen (at most once per second; holding it undoes a single play) |
+| Save / load the board         | `Ctrl+S` / `Ctrl+L` (uses `game.save` in the current directory) |
+| Start a new game after a win  | Left click anywhere                            |
+| Quit                          | `Esc`                                          |
+
+
+## Themes
+
+Pick a color theme with `--theme`:
+
+```bash
+seks --theme catppuccin-mocha
+```
+
+The default theme is `felt`, and `classic` has the original colors of the
+game. Run `seks --help` to list all themes.
+
+<table>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/felt.png" width="160" alt="felt theme"><br><code>felt</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/classic.png" width="160" alt="classic theme"><br><code>classic</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/wood.png" width="160" alt="wood theme"><br><code>wood</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/azulejo.png" width="160" alt="azulejo theme"><br><code>azulejo</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/paper.png" width="160" alt="paper theme"><br><code>paper</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/nord.png" width="160" alt="nord theme"><br><code>nord</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/catppuccin-mocha.png" width="160" alt="catppuccin-mocha theme"><br><code>catppuccin-mocha</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/catppuccin-latte.png" width="160" alt="catppuccin-latte theme"><br><code>catppuccin-latte</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/dracula.png" width="160" alt="dracula theme"><br><code>dracula</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/gruvbox.png" width="160" alt="gruvbox theme"><br><code>gruvbox</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/solarized.png" width="160" alt="solarized theme"><br><code>solarized</code></td>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/tokyo-night.png" width="160" alt="tokyo-night theme"><br><code>tokyo-night</code></td>
+  </tr>
+  <tr>
+    <td align="center"><img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/themes/rose-pine.png" width="160" alt="rose-pine theme"><br><code>rose-pine</code></td>
+  </tr>
+</table>
+
+
+## Rules
+
+### Setup
+
+The board has 11 columns and 11 rows. Each player starts with 16 dice:
+
+* 6 dice showing **1** on their back row, on every other cell;
+* 10 dice showing **2** on the row in front of it, which is full except for the
+  center column.
+
+White starts at the bottom of the screen and Black at the top. **White plays
+first**, and the players take turns after that.
+
+### Your turn
+
+On your turn, click one of your dice to select it, then do **exactly one** of
+the following.
+
+**1. Move.** A die moves in a straight line in any of the 8 directions
+(orthogonal or diagonal) by **at most as many cells as its value**. It cannot
+jump over other dice or land on an occupied cell. After the move, **the die
+shows the number of cells it traveled**: a 4 that moves 2 cells becomes a 2.
+
+When you select a die, every cell it can reach is highlighted, and the number
+shown on each cell is the value the die will have if it lands there. The
+selected die itself shows a preview of its incremented value (see below).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/02-select.png" width="300" alt="A selected die and its possible moves">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/04-move.png" width="300" alt="The die after moving three cells">
+</p>
+
+*Left: a white 2 is selected and can move one or two cells. Right: later on,
+a white 3 moved three cells forward and still shows 3.*
+
+**2. Increment.** Click the selected die again to add 1 to its value. This uses
+up your turn. A die can reach at most **6**. Clicking a selected 6 again only
+cancels the selection.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/03-increment.png" width="300" alt="A white die incremented from 2 to 3">
+</p>
+
+*White spent its first turn turning a 2 into a 3.*
+
+### Captures
+
+Captures are **custodial**: after you move a die, every enemy die that sits
+orthogonally next to the cell where it landed (up, down, left or right) and
+has one of your dice directly on its other side is captured and removed from
+the board.
+
+* A single move can capture in several directions at once.
+* Diagonal neighbors are never captured.
+* Only the player who moves captures: moving a die between two enemy dice is
+  safe.
+* Incrementing a die never captures.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/05-before-capture.png" width="300" alt="Before the capture">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/06-capture.png" width="300" alt="After the capture">
+</p>
+
+*The black 2 is flanked on its right by a white 3. White moves the other 3
+up to the left of the black die and captures it.*
+
+The counters on the left side of the screen show how many dice each player
+has lost. The top counter counts White's losses and the bottom one counts
+Black's.
+
+### Winning
+
+You win as soon as **one of your dice moves onto the opponent's back row**:
+the top row for White, the bottom row for Black.
+
+You also win when, after your play, **your opponent cannot play**: they have
+lost every die, or each of their dice is a 6 with no free cell to move to.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/07-before-victory.png" width="300" alt="A white 3 with a free path to the top row">
+  <img src="https://raw.githubusercontent.com/fabiommendes/seks/main/assets/screenshots/08-victory.png" width="300" alt="White wins">
+</p>
+
+*The center column starts with a gap in the second row. This white 3 uses it
+to reach the top row and win.*
+
+
+## Development
+
+The project uses [uv](https://docs.astral.sh/uv/) and
+[taskipy](https://github.com/taskipy/taskipy):
+
+```bash
+git clone https://github.com/fabiommendes/seks.git
+cd seks
+uv sync
+uv run task --list
+```
+
+The main tasks are `task test`, `task lint`, `task docs`, `task ci` and
+`task release`. `task screenshots` plays a scripted game and regenerates the
+images in this README. See [CONTRIBUTING.md](https://github.com/fabiommendes/seks/blob/main/CONTRIBUTING.md)
+for details.
+
+
+## About the name
+
+*Seks* means "six" in Danish, Norwegian and Faroese, after the highest face of
+a die.
+
+
+## License
+
+Seks is released under the [MIT License](https://github.com/fabiommendes/seks/blob/main/LICENSE).

seks-0.1.0/pyproject.toml

@@ -0,0 +1,148 @@
+[project]
+name = "seks"
+version = "0.1.0"
+description = "Seks: an abstract strategy game played with dice on an 11x11 board."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+dependencies = ["pyxel>=2.3"]
+keywords = [
+    "game",
+    "board-game",
+    "abstract-strategy",
+    "dice",
+    "pyxel",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: X11 Applications",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Games/Entertainment :: Board Games",
+    "Typing :: Typed",
+]
+
+[[project.authors]]
+name = "Fábio Macêdo Mendes"
+email = "fabiomacedomendes@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/fabiommendes/seks"
+Repository = "https://github.com/fabiommendes/seks"
+Issues = "https://github.com/fabiommendes/seks/issues"
+Changelog = "https://github.com/fabiommendes/seks/blob/main/CHANGELOG.md"
+
+[project.scripts]
+seks = "seks.main:main"
+
+[dependency-groups]
+dev = [
+    "doc-zero>=0.2; python_version >= '3.13'",
+    "mypy>=1.15",
+    "pytest>=8.3",
+    "pytest-cov>=6.0",
+    "ruff>=0.11",
+    "taskipy>=1.14",
+]
+
+[build-system]
+requires = ["uv_build>=0.8,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "seks"
+module-root = "."
+source-include = [
+    "tests/**",
+    "CHANGELOG.md",
+]
+source-exclude = ["*.save"]
+wheel-exclude = ["*.save"]
+
+[tool.taskipy.tasks.run]
+cmd = "python -m seks"
+help = "run the game"
+
+[tool.taskipy.tasks.test]
+cmd = "pytest"
+help = "run all tests"
+
+[tool.taskipy.tasks.format]
+cmd = "ruff format . && ruff check . --fix"
+help = "format code and apply safe lint fixes"
+
+[tool.taskipy.tasks.lint]
+cmd = "ruff format --check . && ruff check . && mypy"
+help = "run all linters and type checkers"
+
+[tool.taskipy.tasks.docs]
+cmd = "doc-zero build"
+help = "build the documentation"
+
+[tool.taskipy.tasks.screenshots]
+cmd = "python scripts/screenshots.py"
+help = "play a scripted game and regenerate the README screenshots"
+
+[tool.taskipy.tasks.ci]
+cmd = "task lint && task test && task docs"
+help = "run all CI checks"
+
+[tool.taskipy.tasks.release]
+cmd = "task ci && rm -rf dist && uv build && uvx twine check --strict dist/*"
+help = "check that the project is ready to be published to PyPI"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--import-mode=importlib",
+    "--cov=seks",
+    "--cov-report=term-missing",
+]
+
+[tool.coverage.run]
+omit = ["seks/__main__.py"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+extend-exclude = [
+    ".base-ast",
+    ".base-ast-cache",
+    "docs",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "B",
+    "UP",
+    "SIM",
+    "RUF",
+]
+
+[tool.ruff.lint.flake8-bugbear]
+extend-immutable-calls = ["seks.types.Pos"]
+
+[tool.mypy]
+python_version = "3.12"
+files = [
+    "seks",
+    "tests",
+    "scripts",
+]
+warn_unused_ignores = true
+warn_redundant_casts = true
+check_untyped_defs = true
+
+[[tool.mypy.overrides]]
+module = ["pyxel.*"]
+ignore_missing_imports = true