Metadata-Version: 2.4
Name: comic-parser
Version: 1.1
Summary: Python utility for build comics
Author-email: Pablo Alvarez Lopez <pablo@alvarezlopez.com>
Project-URL: Bug Tracker, https://github.com/palvarezlopez/comic-parser/issues
Project-URL: Documentation, https://github.com/palvarezlopez/comic-parser
Project-URL: Source Code, https://github.com/palvarezlopez/comic-parser
Keywords: comic,pdf
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: img2pdf
Requires-Dist: pillow
Requires-Dist: typing_extensions
Provides-Extra: test
Requires-Dist: pikepdf; extra == "test"
Dynamic: license-file

# comic-parser

Python utility for building comic PDFs from `.zip` and `.cbz` archives.

## Installation

```bash
pip install comic-parser
```

## Usage

```bash
comic-parser <folder> "<comic name>" "<author>"
python -m comic_parser <folder> "<comic name>" "<author>"
```

Optional metadata arguments:

```bash
comic-parser <folder> "<comic name>" "<author>" \
  --subject "<subject>" \
  --keywords "<k1,k2>" \
  --publisher "<publisher>" \
  --series "<series>"
```

Arguments:

- `folder`: directory containing the `.zip` or `.cbz` files to parse.
- `comic name`: base name used for the generated PDF files.
- `author`: author name included in the generated PDF file names.
- `--subject`: optional PDF subject metadata.
- `--keywords`: optional comma-separated PDF keywords.
- `--publisher`: optional publisher/editorial metadata included in the subject/keywords.
- `--series`: optional series metadata included in the subject/keywords.

Generated PDFs now include embedded metadata (title with chapter index, author, subject/keywords, creation/modification date, creator, producer), not only metadata in the file name.

## Example project (`test/`)

Run the executable example script that creates a sample `.cbz`, generates a PDF, and verifies embedded metadata:

```bash
python test/test.py
```
