Metadata-Version: 2.1
Name: demilich
Version: 1.0.0
Summary: Demilich, the MTG skeleton wizard
Home-page: https://github.com/vtbassmatt/demilich
Keywords: game,tcg,mtg,magic
Author: Matt Cooper
Author-email: vtbassmatt@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: typer (>=0.15.1,<0.16.0)
Project-URL: Bug Tracker, https://github.com/vtbassmatt/demilich/issues
Project-URL: Documentation, https://github.com/vtbassmatt/demilich
Project-URL: Repository, https://github.com/vtbassmatt/demilich
Description-Content-Type: text/markdown

# Demilich - the MTG skeleton wizard

A tool for quickly scaffolding a custom MTG set.

## Installation

```shell
% pip install demilich
```

## Basic use

```shell
% demilich play-booster > skeleton.csv
```

Then open `skeleton.csv` in the editor of your choice.

## Custom skeleton

You can use `demilich` with your custom skeleton definition.
I recommend you copy [pb2024.toml](src/demilich/data/pb2024.toml) to use as a starting point.
Once you have your `my-custom-skeleton.toml` ready to go, run:

```shell
% demilich custom-skeleton my-custom-skeleton.toml
```

## Output formats

By default, `demilich` generates a CSV.
You can ask for a pretty-printed table instead with the `--format` option.

```shell
% demilich play-booster --format=table
# or
% demilich custom-skeleton my-custom-skeleton.toml --format=table
```

## Suppressing or including big columns

CSV mode includes all columns by default.

Table mode suppresses the "instruction" column by default.
You can bring it back with `--include-instruction`.
(You'll want a pretty wide terminal for this to make sense.)

```shell
% demilich play-booster --format=table --include-instruction
```

You can additionally suppress card text with `--no-include-text`:

```shell
% demilich play-booster --format=table --no-include-text
```

## Programmatically building a skeleton

The API for `SkeletonGenerator` is documented in docstrings so you can generate skeletons programmatically.
See the examples in `examples/` for ideas on how to do it.

Each `SkeletonGenerator` is only responsible for a single section of a full skeleton.
It keeps a fixed rarity and frame code, which simplifies the implementation quite a bit.
If you need something much fancier, like redistribution keywords that didn't make it into one rarity into another rarity, you can probably achieve that using the programmatic interface.

## Fan content policy

`demilich` is unofficial Fan Content permitted under the [Fan Content Policy][fan-content].
Not approved/endorsed by Wizards.
Portions of the materials used are property of Wizards of the Coast.
©Wizards of the Coast LLC.

[fan-content]: https://company.wizards.com/en/legal/fancontentpolicy

