Metadata-Version: 2.4
Name: historieklokka
Version: 0.1.1
Summary: A history clock for the terminal — military time HH:MM becomes a historical year with a fact from that year.
Project-URL: Homepage, https://historieklokka.no
Project-URL: Repository, https://github.com/pibendik/world-history-clock
Project-URL: Bug Tracker, https://github.com/pibendik/world-history-clock/issues
Author: pibendik
License-Expression: GPL-3.0-only
License-File: LICENSE
Keywords: clock,history,terminal,tui,wikipedia
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: requests>=2.28
Requires-Dist: rich>=13.0
Description-Content-Type: text/markdown

# historieklokka

A history clock for the terminal. Military time **HH:MM** becomes a historical year, with a curated fact from that year — fetched live from [historieklokka.no](https://historieklokka.no).

**15:23** → year **1523** → *"Luther publishes 'On Secular Authority', laying the groundwork for separation of church and state."*

## Install

```bash
pip install historieklokka
```

## Usage

```bash
historieklokka                                     # uses historieklokka.no
historieklokka --api http://localhost:8421/api/v1  # against a local instance
```

Press `Ctrl+C` to exit.

## What it shows

- Current time as a year (e.g. 16:45 → 1645)
- The historical era that year belongs to
- A Wikipedia-sourced fact from that year, rewritten as vivid prose by an LLM
- Future years (after the current year) show curated speculative events

## Publishing to PyPI

```bash
# One-time setup
pip install hatch

# Build
cd cli/
hatch build              # creates dist/historieklokka-*.whl and .tar.gz

# Publish (requires PyPI account + API token at https://pypi.org/manage/account/token/)
hatch publish            # prompts for username (__token__) and token
```

Set `HATCH_INDEX_USER=__token__` and `HATCH_INDEX_AUTH=pypi-...` as environment variables
to skip the prompts.

## License

GPL-3.0-only — see [LICENSE](LICENSE).
