Metadata-Version: 2.4
Name: hexdoc-hexthings
Version: 0.1.2.1.20.1.1.2
Summary: Some extra patterns I think would be neat
Project-URL: Homepage, https://real-septicake.github.io/HexThings
Project-URL: Source, https://github.com/Real-Septicake/HexThings
Author: Real-Septicake
License-File: LICENSE
Keywords: hexdoc
Requires-Python: >=3.12
Requires-Dist: hexdoc-hexcasting~=0.11.2.1.0
Description-Content-Type: text/markdown

# hexdoc-hexthings

Python web book docgen and [hexdoc](https://pypi.org/project/hexdoc) plugin for HexThings.

Some extra patterns I think would be neat

## Version scheme

We use [hatch-gradle-version](https://pypi.org/project/hatch-gradle-version) to generate the version number based on whichever mod version the docgen was built with.

The version is in this format: `mod-version.python-version.mod-pre.python-dev.python-post`

For example:
* Mod version: `0.11.1-7`
* Python package version: `1.0.dev0`
* Full version: `0.11.1.1.0rc7.dev0`

## Setup

Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then:

```sh
uv sync

.\.venv\Scripts\activate   # Windows
. .venv/bin/activate.fish  # fish
source .venv/bin/activate  # everything else
```

## Usage

For local testing, create a file called `.env` in the repo root following this template:

```sh
GITHUB_REPOSITORY=Real-Septicake/HexThings
GITHUB_SHA=main
GITHUB_PAGES_URL=https://real-septicake.github.io/HexThings
```

Useful commands:

```sh
# update your Python environment and lockfile if you added new dependencies
uv sync

# show help
hexdoc -h

# render and serve the web book in watch mode
nodemon --config doc/nodemon.json

# render and serve the web book
hexdoc serve

# build and merge the web book
hexdoc build
hexdoc merge

# start the Python interpreter with some extra local variables
hexdoc repl
```
