parse_qwantz 2026.5.4__tar.gz

parse_qwantz-2026.5.4/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023 Jan Szejko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

parse_qwantz-2026.5.4/MANIFEST.in

@@ -0,0 +1,3 @@
+include parse_qwantz/img/*
+include parse_qwantz/data/*
+include parse_qwantz/dict/*

parse_qwantz-2026.5.4/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: parse_qwantz
+Version: 2026.5.4
+Summary: Transcript generator for Dinosaur Comics
+Author-email: Jan Szejko <jan.szejko@gmail.com>
+License-Expression: MIT
+Project-URL: homepage, https://github.com/janek37/parse_qwantz
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow
+Requires-Dist: typer
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# Dinosaur Comic Parser
+
+A transcript generator for [Ryan North](https://www.ryannorth.ca/)'s [Dinosaur Comics](https://qwantz.com)
+
+## Installation
+
+Install `parse-qwantz` with `pip`
+
+```bash
+  pip install parse-qwantz
+```
+
+## Usage
+
+You need to download the image file for the comic you want transcribed, for example https://qwantz.com/comics/comic2-02.png. Then run `parse-qwantz`:
+
+```
+$ parse-qwantz comic2-02.png
+T-Rex: Today is a beautiful day to be stomping on things! As a dinosaur, stomping is the best part of my day indeed!
+
+T-Rex: *gasp*
+
+T-Rex: What's that, little house? You wish you were back in your own time? THAT IS TOO BAD FOR YOU
+
+T-Rex: Perhaps you too will get a stomping, little girl!
+Utahraptor: WAIT!
+
+Utahraptor: Is stomping really the answer to your problem(s)?
+T-Rex: Problem(s)?
+
+T-Rex: My only problem(s) have to do with you interrupting my stomping!
+T-Rex: 〚small〛 crazy utahraptor!
+```
+
+You can also call it with
+```bash
+python -m parse_qwantz
+```
+
+The argument can also be a directory path instead of a file path. In such case the program will run on all files in the specified directory.
+
+## Options
+
+### `--output-dir`
+
+By default, the program outputs to stdout and logs to stderr. With this option, when processing file `image_name.png` it will output to `OUTPUT_DIR/image_name.png.txt` and log to `OUTPUT_DIR/image_name.log`.
+
+### `--generate-svg`
+
+Instead of transcribing the comic, generate a vectorized version in the SVG format and print it to the standard output.
+
+### `--parse-footer`
+
+Instead of transcribing the comic, transcribe just the footer.
+
+## Conventions
+
+Bold and italics are marked with "◖◗" and "▹◃" respectively. This is to avoid ambiguity which may result from using characters like "*" or "_".
+
+All descriptions are in "〚〛" brackets. Each line that isn't just description starts from a "character" name followed by a colon. That "character" might be one of the actual characters, but also "Narrator", "Off panel", "Banner", "Book cover" etc.
+
+When some text in a panel is obscured but can be reconstructed, it's in "⦃⦄" braces. So far this applies only to 2 comics: #59 and #61.
+
+When some text in a panel is obscured and not reconstructed, it's replaced either by the special "…" character, or a description of how it's obscured in "〚〛" brackets.
+
+## Notes
+
+This program still does not work on all DC strips, but at this point it should work correctly on pretty much all "standard" strips and some less-standard ones (thanks to the system of overrides). Eventually all existing strips should work, including the guest comics, with updates for new comics coming out regularly.
+
+After all comics are working, I might add some other features, like generating SVG images.
+
+## Running Tests
+
+To run tests, run the following command:
+
+```bash
+  pytest test/
+```
+
+## Acknowledgments
+
+This program would not be possible without the wonderful comics by Ryan North! Thanks, Ryan, and congratulations on the 20th anniversary of your comics! Btw [the anniversary comic](https://qwantz.com/?comic=4005) will totally not work with this script, haha! (at least until I add an override)

parse_qwantz-2026.5.4/README.md

@@ -0,0 +1,82 @@
+# Dinosaur Comic Parser
+
+A transcript generator for [Ryan North](https://www.ryannorth.ca/)'s [Dinosaur Comics](https://qwantz.com)
+
+## Installation
+
+Install `parse-qwantz` with `pip`
+
+```bash
+  pip install parse-qwantz
+```
+
+## Usage
+
+You need to download the image file for the comic you want transcribed, for example https://qwantz.com/comics/comic2-02.png. Then run `parse-qwantz`:
+
+```
+$ parse-qwantz comic2-02.png
+T-Rex: Today is a beautiful day to be stomping on things! As a dinosaur, stomping is the best part of my day indeed!
+
+T-Rex: *gasp*
+
+T-Rex: What's that, little house? You wish you were back in your own time? THAT IS TOO BAD FOR YOU
+
+T-Rex: Perhaps you too will get a stomping, little girl!
+Utahraptor: WAIT!
+
+Utahraptor: Is stomping really the answer to your problem(s)?
+T-Rex: Problem(s)?
+
+T-Rex: My only problem(s) have to do with you interrupting my stomping!
+T-Rex: 〚small〛 crazy utahraptor!
+```
+
+You can also call it with
+```bash
+python -m parse_qwantz
+```
+
+The argument can also be a directory path instead of a file path. In such case the program will run on all files in the specified directory.
+
+## Options
+
+### `--output-dir`
+
+By default, the program outputs to stdout and logs to stderr. With this option, when processing file `image_name.png` it will output to `OUTPUT_DIR/image_name.png.txt` and log to `OUTPUT_DIR/image_name.log`.
+
+### `--generate-svg`
+
+Instead of transcribing the comic, generate a vectorized version in the SVG format and print it to the standard output.
+
+### `--parse-footer`
+
+Instead of transcribing the comic, transcribe just the footer.
+
+## Conventions
+
+Bold and italics are marked with "◖◗" and "▹◃" respectively. This is to avoid ambiguity which may result from using characters like "*" or "_".
+
+All descriptions are in "〚〛" brackets. Each line that isn't just description starts from a "character" name followed by a colon. That "character" might be one of the actual characters, but also "Narrator", "Off panel", "Banner", "Book cover" etc.
+
+When some text in a panel is obscured but can be reconstructed, it's in "⦃⦄" braces. So far this applies only to 2 comics: #59 and #61.
+
+When some text in a panel is obscured and not reconstructed, it's replaced either by the special "…" character, or a description of how it's obscured in "〚〛" brackets.
+
+## Notes
+
+This program still does not work on all DC strips, but at this point it should work correctly on pretty much all "standard" strips and some less-standard ones (thanks to the system of overrides). Eventually all existing strips should work, including the guest comics, with updates for new comics coming out regularly.
+
+After all comics are working, I might add some other features, like generating SVG images.
+
+## Running Tests
+
+To run tests, run the following command:
+
+```bash
+  pytest test/
+```
+
+## Acknowledgments
+
+This program would not be possible without the wonderful comics by Ryan North! Thanks, Ryan, and congratulations on the 20th anniversary of your comics! Btw [the anniversary comic](https://qwantz.com/?comic=4005) will totally not work with this script, haha! (at least until I add an override)

parse_qwantz-2026.5.4/parse_qwantz/__init__.py

@@ -0,0 +1,2 @@
+from parse_qwantz.cli import app
+from parse_qwantz.main import main

parse_qwantz-2026.5.4/parse_qwantz/__main__.py

@@ -0,0 +1,5 @@
+from parse_qwantz.cli import app
+
+
+if __name__ == '__main__':
+    app()

parse_qwantz-2026.5.4/parse_qwantz/box.py

@@ -0,0 +1,103 @@
+import math
+from typing import NamedTuple
+
+from parse_qwantz.pixels import Pixel
+
+
+class Box(NamedTuple):
+    top_left: Pixel
+    bottom_right: Pixel
+    inactive_sides: tuple[str, ...] = ()
+
+    def __repr__(self):
+        return f"Box(top_left={repr(self.top_left)}, bottom_right={repr(self.bottom_right)})"
+
+    @property
+    def top_right(self) -> Pixel:
+        return Pixel(self.bottom_right.x, self.top_left.y)
+
+    @property
+    def bottom_left(self) -> Pixel:
+        return Pixel(self.top_left.x, self.bottom_right.y)
+
+    @property
+    def left(self) -> int:
+        return self.top_left.x
+
+    @property
+    def right(self) -> int:
+        return self.bottom_right.x
+
+    @property
+    def top(self) -> int:
+        return self.top_left.y
+
+    @property
+    def bottom(self) -> int:
+        return self.bottom_right.y
+
+    @property
+    def width(self) -> int:
+        return self.right - self.left
+
+    @property
+    def height(self) -> int:
+        return self.bottom - self.top
+
+    def includes(self, pixel: Pixel) -> bool:
+        return self.left <= pixel.x < self.right and self.top <= pixel.y < self.bottom
+
+    def contains(self, box: "Box") -> bool:
+        return self.includes(box.top_left) and self.includes(box.bottom_right)
+
+    def distance_squared(self, box: "Box") -> int:
+        return (
+            get_interval_distance((self.left, self.right), (box.left, box.right))**2
+            + get_interval_distance((self.top, self.bottom), (box.top, box.bottom))**2
+        )
+
+    def distance(self, pixel: Pixel) -> float | None:
+        if self.includes(pixel):
+            return 0
+        top_active = "top" not in self.inactive_sides
+        bottom_active = "bottom" not in self.inactive_sides
+        left_active = "left" not in self.inactive_sides
+        right_active = "right" not in self.inactive_sides
+        if self.left <= pixel.x < self.right:
+            if pixel.y < self.top:
+                return self.top - pixel.y if top_active else None
+            else:
+                return pixel.y - self.bottom + 1 if bottom_active else None
+        if self.top <= pixel.y < self.bottom:
+            if pixel.x < self.left:
+                return self.left - pixel.x if left_active else None
+            else:
+                return pixel.x - self.right + 1 if right_active else None
+        if pixel.x >= self.right and pixel.y >= self.bottom and (right_active or bottom_active):
+            return get_distance(pixel, self.bottom_right)
+        if pixel.x >= self.right and pixel.y < self.top and (right_active or top_active):
+            return get_distance(pixel, self.top_right)
+        if pixel.x < self.left and pixel.y >= self.bottom and (left_active or bottom_active):
+            return get_distance(pixel, self.bottom_left)
+        if pixel.x < self.left and pixel.y < self.top and (left_active or top_active):
+            return get_distance(pixel, self.top_left)
+        return None
+
+    def with_margin(self, margin_x: int, margin_y: int):
+        return Box(
+            Pixel(self.left - margin_x, self.top - margin_y),
+            Pixel(self.right + margin_x, self.bottom + margin_y),
+        )
+
+    @classmethod
+    def dummy(cls) -> "Box":
+        return cls(Pixel(0, 0), Pixel(0, 0))
+
+
+def get_interval_distance(interval1: tuple[int, int], interval2: tuple[int, int]) -> int:
+    i1, i2 = sorted((interval1, interval2))
+    return max(0, i2[0] - i1[1])
+
+
+def get_distance(p1: Pixel, p2: Pixel) -> float:
+    return math.sqrt((p1.x - p2.x)**2 + (p1.y - p2.y)**2)