Metadata-Version: 2.3
Name: vasara
Version: 0.2.0
Summary: A fun little command-line tool for fetching random Warhammer lore snippets from the wikis.
License: GPL-3.0-only
Author: It Ankka
Author-email: github@cote.mozmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
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
Requires-Dist: requests (>=2.32.5,<3.0.0)
Requires-Dist: wikitextparser (>=0.56.4,<0.57.0)
Description-Content-Type: text/markdown

# Vasara
A fun little command-line tool for fetching random Warhammer lore snippets from the wikis.

## Usage

`vasara` is a command-line tool for fetching random Warhammer lore snippets.

```bash
vasara [universe] [OPTIONS]
```

### Arguments:

*   **`universe`**: The Warhammer universe you want to get lore snippets from.
    *   Choices: `40k`, `fantasy`, `aos`
    *   Default: `40k`

### Options:

*   `-c`, `--count <COUNT>`: Number of lore snippets to fetch.
    *   Default: `1`
*   `-p`, `--paragraph`: Fetch a full paragraph instead of a snippet.
*   `-m`, `--max-length <MAX_LENGTH>`: Maximum length of the snippets.
    *   Default: `190`
*   `-f`, `--format <FORMAT>`: Output format.
    *   Choices: `text`, `json`
    *   Default: `text`
*   `--retries <RETRIES>`: Number of retries to attempt before cancelling.
    *   Default: `5`
*   `--max-workers <RETRIES>`: Max number of worker threads used for concurrently querying the wiki.
    *   Default: `500`

## Examples

Fetch a single Warhammer 40,000 lore snippet (default):

```bash
vasara
```

Fetch 3 Age of Sigmar lore snippets:

```bash
vasara aos --count 3
```

Fetch a full paragraph of Warhammer Fantasy Battles lore:

```bash
vasara fantasy --paragraph
```

Fetch lore in JSON format:

```bash
vasara 40k --count 2 --format json
```

