initial commit

Author: arthur-van-acker

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    env:
+      TICTACTOE_HEADLESS: "1"
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+      - name: Run linters
+        run: |
+          python -m black --check src tests
+          python -m ruff check src tests
+      - name: Type checking
+        run: python -m mypy src
+      - name: Run tests (non-GUI)
+        run: python -m pytest -m "not gui"
+      - name: Build and smoke-test wheel
+        run: |
+          python -m build --wheel
+          python -m pip install dist/*.whl --force-reinstall
+          python -c "import tictactoe; print(tictactoe.__version__)"

.gitignore

@@ -0,0 +1,48 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+.Python
+
+# IDE / Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Type checkers / Linters
+.mypy_cache/
+.ruff_cache/
+.pytype/
+
+# Testing
+.tox/
+
+# Logs
+*.log
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Environment files
+.env
+.env.*
+
+# macOS noise
+.DS_Store

.pre-commit-config.yaml

@@ -0,0 +1,48 @@
+default_language_version:
+  python: python3
+minimum_pre_commit_version: "3.5.0"
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+  - id: check-yaml
+  - id: check-toml
+- repo: https://github.com/psf/black
+  rev: 24.8.0
+  hooks:
+  - id: black
+    language_version: python3
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.6.7
+  hooks:
+  - id: ruff
+    args: [ "--fix" ]
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.11.2
+  hooks:
+  - id: mypy
+    additional_dependencies:
+    - types-colorama
+- repo: local
+  hooks:
+  - id: pytest-non-gui-commit
+    name: pytest (non-gui suite)
+    entry: python -m pytest -m "not gui"
+    language: system
+    pass_filenames: false
+    stages: [ pre-commit ]
+  - id: pytest-non-gui
+    name: pytest (non-gui suite)
+    entry: python -m pytest -m "not gui"
+    language: system
+    pass_filenames: false
+    stages: [ pre-push ]
+  - id: tox-lint-type
+    name: tox lint+type
+    entry: python -m tox -e lint,type
+    language: system
+    pass_filenames: false
+    stages: [ pre-push ]

LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2025 Arthur van Acker
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.