# Ultimate tic-tac-toe
♟️ Ultimate tic-tac-toe game GUI application using Python and PyGame
<p align=center>
<img src="https://github.com/user-attachments/assets/c6fd92b5-f10a-4507-8627-4acdddd829ba">
</p>
🎨 Has a GUI! \
🤖 Uses GitHub Actions to produce PyInstaller binaries \
🏫 Made for UW-Whitewater Introduction to Python Programming final project \
🧠 Learned about [uv](https://docs.astral.sh/uv/)
## Installation
The best way to install this application is to download the platform-specific precompiled binary from [the latest release](https://github.com/jcbhmr/ultttt/releases/latest).
<dl>
<dt>Windows x86-64
<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-win_amd64-1.0.0.zip
<dt>macOS x86-64
<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-macosx_10_9_x86_64-1.0.0.tar.gz
<dt>macOS AArch64
<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-macosx_11_0_arm64-1.0.0.tar.gz
<dt>Linux x86-64
<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-linux_x86_64-1.0.0.tar.gz
</dl>
This package is also published to PyPI if you prefer to install it from there:
```sh
uv tool install ultttt
```
## Development
This project uses [uv](https://docs.astral.sh/uv/) as its Python toolchain. Why uv and not Poetry or something else? Because uv unifies everything _including installing the right Python version_. uv is [not a task runner yet](https://github.com/astral-sh/uv/issues/5903) and as such we use [Poe the Poet](https://poethepoet.natn.io/) to define our tasks.
The most interesting thing to do is build the `ultttt` executable binary using [PyInstaller](https://pyinstaller.org/):
```sh
uv run poe build-exe
```
Release process:
1. Change the version in `pyproject.toml`
2. Change the URLs in the readme to match the new version that you are about to release
3. Run the release workflow manually
4. Make sure it looks good
5. Publish the release to trigger the PyPI release workflow
6. Make sure that works and you're done! 🎉
Raw data
{
"_id": null,
"home_page": null,
"name": "ultttt",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "board-game, gui, pygame, python, tic-tac-toe, ultimate-tic-tac-toe, uv",
"author": null,
"author_email": "Jacob Hummer <jcbhmr@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/ba/6c/a33970d7c76a8ed192b2dabc68b69f4bf0a39464e43bff4d00732173f0da/ultttt-1.0.0.tar.gz",
"platform": null,
"description": "# Ultimate tic-tac-toe\n\n\u265f\ufe0f Ultimate tic-tac-toe game GUI application using Python and PyGame\n\n<p align=center>\n <img src=\"https://github.com/user-attachments/assets/c6fd92b5-f10a-4507-8627-4acdddd829ba\">\n</p>\n\n\ud83c\udfa8 Has a GUI! \\\n\ud83e\udd16 Uses GitHub Actions to produce PyInstaller binaries \\\n\ud83c\udfeb Made for UW-Whitewater Introduction to Python Programming final project \\\n\ud83e\udde0 Learned about [uv](https://docs.astral.sh/uv/)\n\n## Installation\n\n\n\n\nThe best way to install this application is to download the platform-specific precompiled binary from [the latest release](https://github.com/jcbhmr/ultttt/releases/latest).\n\n<dl>\n<dt>Windows x86-64\n<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-win_amd64-1.0.0.zip\n<dt>macOS x86-64\n<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-macosx_10_9_x86_64-1.0.0.tar.gz\n<dt>macOS AArch64\n<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-macosx_11_0_arm64-1.0.0.tar.gz\n<dt>Linux x86-64\n<dd>https://github.com/jcbhmr/ultttt/releases/download/v1.0.0/ultttt-linux_x86_64-1.0.0.tar.gz\n</dl>\n\nThis package is also published to PyPI if you prefer to install it from there:\n\n```sh\nuv tool install ultttt\n```\n\n## Development\n\n\n\n\nThis project uses [uv](https://docs.astral.sh/uv/) as its Python toolchain. Why uv and not Poetry or something else? Because uv unifies everything _including installing the right Python version_. uv is [not a task runner yet](https://github.com/astral-sh/uv/issues/5903) and as such we use [Poe the Poet](https://poethepoet.natn.io/) to define our tasks.\n\nThe most interesting thing to do is build the `ultttt` executable binary using [PyInstaller](https://pyinstaller.org/):\n\n```sh\nuv run poe build-exe\n```\n\nRelease process:\n\n1. Change the version in `pyproject.toml`\n2. Change the URLs in the readme to match the new version that you are about to release\n3. Run the release workflow manually\n4. Make sure it looks good\n5. Publish the release to trigger the PyPI release workflow\n6. Make sure that works and you're done! \ud83c\udf89\n",
"bugtrack_url": null,
"license": null,
"summary": "\u265f\ufe0f Ultimate tic-tac-toe game GUI application using Python and PyGame",
"version": "1.0.0",
"project_urls": {
"download": "https://github.com/jcbhmr/ultttt/releases/latest",
"homepage": "https://github.com/jcbhmr/ultttt",
"source": "https://github.com/jcbhmr/ultttt.git"
},
"split_keywords": [
"board-game",
" gui",
" pygame",
" python",
" tic-tac-toe",
" ultimate-tic-tac-toe",
" uv"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "59f65b32f88481c2326b1153ed04e29159cbb0253241a9f5ee6325d316e8e362",
"md5": "474e0f09f162a3b7d235a55b743de33c",
"sha256": "5ab49452746267fd339fac49ea93fb4867d9d46553558a794d2b3aa6612b72d8"
},
"downloads": -1,
"filename": "ultttt-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "474e0f09f162a3b7d235a55b743de33c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 26612,
"upload_time": "2024-11-27T23:00:58",
"upload_time_iso_8601": "2024-11-27T23:00:58.327220Z",
"url": "https://files.pythonhosted.org/packages/59/f6/5b32f88481c2326b1153ed04e29159cbb0253241a9f5ee6325d316e8e362/ultttt-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ba6ca33970d7c76a8ed192b2dabc68b69f4bf0a39464e43bff4d00732173f0da",
"md5": "444dce74ec52263a1476a5c92188d71e",
"sha256": "bf269d8cf8064399dca29de0adc82b7281f173b5bede6a106441cfdfcc668988"
},
"downloads": -1,
"filename": "ultttt-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "444dce74ec52263a1476a5c92188d71e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 141393,
"upload_time": "2024-11-27T23:00:59",
"upload_time_iso_8601": "2024-11-27T23:00:59.649576Z",
"url": "https://files.pythonhosted.org/packages/ba/6c/a33970d7c76a8ed192b2dabc68b69f4bf0a39464e43bff4d00732173f0da/ultttt-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-27 23:00:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jcbhmr",
"github_project": "ultttt",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ultttt"
}
JSON
