Metadata-Version: 2.4
Name: pongclock
Version: 0.1.0
Summary: A terminal clock played as an endless game of Pong
Author: ChomChomp
License-Expression: MIT
Project-URL: Homepage, https://github.com/ChomChomp/pongclock
Project-URL: Issues, https://github.com/ChomChomp/pongclock/issues
Project-URL: Source, https://github.com/ChomChomp/pongclock
Keywords: clock,pong,terminal,textual,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
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: Topic :: Games/Entertainment
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: textual>=0.80
Dynamic: license-file

# Pong Clock

A terminal clock played as an endless game of Pong, built with
[Textual](https://textual.textualize.io/).

The left paddle plays for the **hours**, the right paddle plays for the
**minutes**, and the scoreboard *is* the current time. Both paddles play
perfect defense — until the clock is about to tick. When a minute passes,
the hours player deliberately misses so the minutes side scores. When the
hour rolls over, the minutes player misses, the hours side scores, and the
minutes score resets to 00. The ball's speed is quietly adjusted mid-rally
so it crosses the goal line right on the minute boundary.

Rendering uses half-block characters (`▀`) for double vertical resolution,
redrawn at 60 fps with a tiny framebuffer, so the animation stays fluid.

## Install

Install Pong Clock with [pipx](https://pipx.pypa.io/):

```sh
pipx install pongclock
```

Then run:

```sh
pongclock
```

| Key     | Action |
| ------- | ------ |
| `q`     | Quit   |
| `space` | Pause  |

## Develop from source

```sh
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/pongclock
```

## Test

```sh
.venv/bin/python smoke_test.py
```

Runs the app headless, verifies the ball animates, forces a scoring event,
and checks the pause toggle.
