ar-book-labels 0.1.0__tar.gz

ar_book_labels-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TonyBlur
+
+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.

ar_book_labels-0.1.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: ar-book-labels
+Version: 0.1.0
+Summary: Generate printable Accelerated Reader book labels from an Excel spreadsheet.
+Author: TonyBlur
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/TonyBlur/ar-book-labels
+Project-URL: Issues, https://github.com/TonyBlur/ar-book-labels/issues
+Keywords: accelerated-reader,labels,education,printing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openpyxl>=3.0
+Dynamic: license-file
+
+# ar-book-labels
+
+English | **[简体中文](README.zh.md)**
+
+Generate printable [Accelerated Reader](https://www.renaissance.com/accelerated-reader/) book labels from an Excel spreadsheet. Labels include book title, author, AR level (with standard color coding), points, and quiz number — formatted for sticker-style printing and sticking on books.
+
+## Features
+
+- **Standard AR color coding**: 12 color ranges from yellow (0.1–1.5) to brown (6.6+)
+- **Print-ready HTML output**: 4 columns x 9 rows = 36 labels per page, A4 size, `@page` CSS for direct printing
+- **Smart text truncation**: Titles wrap to 2 lines with ellipsis; authors on 1 line
+- **Author-first layout**: Author name appears above title for easy shelf sorting
+- **Screen preview**: SVG viewBox scaling for crisp browser preview
+- **Template included**: Reference Excel template with sample data and column documentation
+
+## Installation
+
+```bash
+pip install ar-book-labels
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+pip install -e .
+```
+
+## Quick Start
+
+1. **Get the template** (optional — if you don't have an Excel file yet):
+
+```bash
+ar-book-labels --template
+```
+
+This copies `ar_template.xlsx` to your current directory. Fill it with your book data.
+
+2. **Generate labels**:
+
+```bash
+ar-book-labels books.xlsx -o labels.html
+```
+
+3. **Open** `labels.html` in a browser to preview, then print (Ctrl/Cmd+P).
+
+   > **Print tip**: In the browser print dialog, choose **"Actual size"** (or **"No margins"** / **"None"** for margins) to prevent the browser from auto-adding page margins that shift label positions. The HTML already declares `@page { margin: 0 }`; adding browser margins on top causes misalignment.
+
+## CLI Usage
+
+```
+ar-book-labels <excel> [options]
+```
+
+### Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `excel` | Path to the Excel file (.xlsx) |
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-o, --output` | `AR_Book_Labels.html` | Output HTML file path |
+| `-s, --sheet` | first sheet | Sheet name to read (defaults to first sheet) |
+| `--col-title` | `AR Title` | Excel column name for book title |
+| `--col-author` | `AR Author` | Excel column name for author |
+| `--col-level` | `Book Level` | Excel column name for book level |
+| `--col-points` | `AR Points` | Excel column name for AR points |
+| `--col-quiz` | `Quiz Number` | Excel column name for quiz number |
+| `--start-row` | `2` | 1-indexed row where data begins (1 = header row) |
+| `--scale` | `1` | Display scale factor for screen preview |
+| `--bw` | — | Black-and-white mode: white circle with thin black outline, black level number |
+| `--template` | — | Copy the reference Excel template to cwd and exit |
+| `-V, --version` | — | Show version and exit |
+
+### Examples
+
+```bash
+# Basic usage
+ar-book-labels my_books.xlsx
+
+# Custom output path and sheet name
+ar-book-labels my_books.xlsx -o output/labels.html -s "Book Data"
+
+# Custom column names (if your Excel uses different headers)
+ar-book-labels my_books.xlsx --col-title "Title" --col-author "Author Name" --col-level "Level"
+
+# Custom start row (e.g. data starts on row 3)
+ar-book-labels my_books.xlsx --start-row 3
+
+# Copy the template for reference
+ar-book-labels --template
+
+# Black-and-white mode for economical printing
+ar-book-labels my_books.xlsx --bw
+```
+
+## Excel Format
+
+The spreadsheet must contain these columns (default names shown; use `--col-*` options to map custom names):
+
+| Internal Key | Default Column | Type | Description |
+|--------------|----------------|------|-------------|
+| `title` | `AR Title` | text | Book title |
+| `author` | `AR Author` | text | Author name |
+| `level` | `Book Level` | number | AR ATOS level (e.g. 5.1) |
+| `points` | `AR Points` | number | Points value |
+| `quiz` | `Quiz Number` | number/text | Quiz ID |
+
+Rows with missing required fields are skipped with a warning printed to stderr.
+
+Use `ar-book-labels --template` to get a pre-formatted template with sample data.
+
+## AR Level Color Chart
+
+| Level Range | Color | Hex |
+|-------------|-------|-----|
+| 0.1 – 1.5 | Yellow | `#FFD700` |
+| 1.6 – 2.0 | Green | `#2E8B57` |
+| 2.1 – 2.5 | Dark Blue | `#00008B` |
+| 2.6 – 3.0 | Red | `#DC143C` |
+| 3.1 – 3.5 | Pink | `#FF69B4` |
+| 3.6 – 4.0 | Purple | `#800080` |
+| 4.1 – 4.5 | Orange | `#FF8C00` |
+| 4.6 – 5.0 | Light Blue | `#00BFFF` |
+| 5.1 – 5.5 | Neon Orange | `#FF6600` |
+| 5.6 – 6.0 | Neon Green | `#39FF14` |
+| 6.1 – 6.5 | Black | `#1C1C1C` |
+| 6.6+ | Brown | `#8B4513` |
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+```
+
+### Project Structure
+
+```
+ar-book-labels/
+  ar_book_labels/
+    __init__.py        # Package metadata and public API
+    generator.py       # Core label generation logic
+    cli.py             # CLI entry point (argparse)
+    __main__.py        # python -m ar_book_labels support
+    templates/
+      ar_template.xlsx # Reference Excel template
+  tests/
+    test_generator.py  # Unit tests
+  pyproject.toml       # Build configuration (setuptools)
+  LICENSE              # MIT License
+  README.md            # This file (English)
+  README.zh.md         # 中文文档
+```
+
+### Running Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+### Building & Publishing
+
+```bash
+pip install build twine
+python -m build
+twine check dist/*
+twine upload dist/*
+```
+
+### Automated Publishing (GitHub Actions)
+
+This project uses a GitHub Actions workflow to automatically publish to PyPI when a new release is created:
+
+1. Bump the version in `pyproject.toml`
+2. Create a new release on GitHub (via the web UI or `gh release create`)
+3. The `publish.yml` workflow will automatically build the package and publish it to PyPI using [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no API token needed)
+
+**Prerequisites**: Configure a [Trusted Publisher](https://docs.pypi.org/trusted-publishers/creating-a-project-through-oidc/) on PyPI for the `ar-book-labels` project, linking it to the `TonyBlur/ar-book-labels` repository and the `pypi` environment.
+
+### Code Style
+
+- Python 3.8+
+- No external dependencies beyond `openpyxl`
+- Keep the generator logic self-contained and testable
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ar_book_labels-0.1.0/README.md

@@ -0,0 +1,198 @@
+# ar-book-labels
+
+English | **[简体中文](README.zh.md)**
+
+Generate printable [Accelerated Reader](https://www.renaissance.com/accelerated-reader/) book labels from an Excel spreadsheet. Labels include book title, author, AR level (with standard color coding), points, and quiz number — formatted for sticker-style printing and sticking on books.
+
+## Features
+
+- **Standard AR color coding**: 12 color ranges from yellow (0.1–1.5) to brown (6.6+)
+- **Print-ready HTML output**: 4 columns x 9 rows = 36 labels per page, A4 size, `@page` CSS for direct printing
+- **Smart text truncation**: Titles wrap to 2 lines with ellipsis; authors on 1 line
+- **Author-first layout**: Author name appears above title for easy shelf sorting
+- **Screen preview**: SVG viewBox scaling for crisp browser preview
+- **Template included**: Reference Excel template with sample data and column documentation
+
+## Installation
+
+```bash
+pip install ar-book-labels
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+pip install -e .
+```
+
+## Quick Start
+
+1. **Get the template** (optional — if you don't have an Excel file yet):
+
+```bash
+ar-book-labels --template
+```
+
+This copies `ar_template.xlsx` to your current directory. Fill it with your book data.
+
+2. **Generate labels**:
+
+```bash
+ar-book-labels books.xlsx -o labels.html
+```
+
+3. **Open** `labels.html` in a browser to preview, then print (Ctrl/Cmd+P).
+
+   > **Print tip**: In the browser print dialog, choose **"Actual size"** (or **"No margins"** / **"None"** for margins) to prevent the browser from auto-adding page margins that shift label positions. The HTML already declares `@page { margin: 0 }`; adding browser margins on top causes misalignment.
+
+## CLI Usage
+
+```
+ar-book-labels <excel> [options]
+```
+
+### Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `excel` | Path to the Excel file (.xlsx) |
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-o, --output` | `AR_Book_Labels.html` | Output HTML file path |
+| `-s, --sheet` | first sheet | Sheet name to read (defaults to first sheet) |
+| `--col-title` | `AR Title` | Excel column name for book title |
+| `--col-author` | `AR Author` | Excel column name for author |
+| `--col-level` | `Book Level` | Excel column name for book level |
+| `--col-points` | `AR Points` | Excel column name for AR points |
+| `--col-quiz` | `Quiz Number` | Excel column name for quiz number |
+| `--start-row` | `2` | 1-indexed row where data begins (1 = header row) |
+| `--scale` | `1` | Display scale factor for screen preview |
+| `--bw` | — | Black-and-white mode: white circle with thin black outline, black level number |
+| `--template` | — | Copy the reference Excel template to cwd and exit |
+| `-V, --version` | — | Show version and exit |
+
+### Examples
+
+```bash
+# Basic usage
+ar-book-labels my_books.xlsx
+
+# Custom output path and sheet name
+ar-book-labels my_books.xlsx -o output/labels.html -s "Book Data"
+
+# Custom column names (if your Excel uses different headers)
+ar-book-labels my_books.xlsx --col-title "Title" --col-author "Author Name" --col-level "Level"
+
+# Custom start row (e.g. data starts on row 3)
+ar-book-labels my_books.xlsx --start-row 3
+
+# Copy the template for reference
+ar-book-labels --template
+
+# Black-and-white mode for economical printing
+ar-book-labels my_books.xlsx --bw
+```
+
+## Excel Format
+
+The spreadsheet must contain these columns (default names shown; use `--col-*` options to map custom names):
+
+| Internal Key | Default Column | Type | Description |
+|--------------|----------------|------|-------------|
+| `title` | `AR Title` | text | Book title |
+| `author` | `AR Author` | text | Author name |
+| `level` | `Book Level` | number | AR ATOS level (e.g. 5.1) |
+| `points` | `AR Points` | number | Points value |
+| `quiz` | `Quiz Number` | number/text | Quiz ID |
+
+Rows with missing required fields are skipped with a warning printed to stderr.
+
+Use `ar-book-labels --template` to get a pre-formatted template with sample data.
+
+## AR Level Color Chart
+
+| Level Range | Color | Hex |
+|-------------|-------|-----|
+| 0.1 – 1.5 | Yellow | `#FFD700` |
+| 1.6 – 2.0 | Green | `#2E8B57` |
+| 2.1 – 2.5 | Dark Blue | `#00008B` |
+| 2.6 – 3.0 | Red | `#DC143C` |
+| 3.1 – 3.5 | Pink | `#FF69B4` |
+| 3.6 – 4.0 | Purple | `#800080` |
+| 4.1 – 4.5 | Orange | `#FF8C00` |
+| 4.6 – 5.0 | Light Blue | `#00BFFF` |
+| 5.1 – 5.5 | Neon Orange | `#FF6600` |
+| 5.6 – 6.0 | Neon Green | `#39FF14` |
+| 6.1 – 6.5 | Black | `#1C1C1C` |
+| 6.6+ | Brown | `#8B4513` |
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+```
+
+### Project Structure
+
+```
+ar-book-labels/
+  ar_book_labels/
+    __init__.py        # Package metadata and public API
+    generator.py       # Core label generation logic
+    cli.py             # CLI entry point (argparse)
+    __main__.py        # python -m ar_book_labels support
+    templates/
+      ar_template.xlsx # Reference Excel template
+  tests/
+    test_generator.py  # Unit tests
+  pyproject.toml       # Build configuration (setuptools)
+  LICENSE              # MIT License
+  README.md            # This file (English)
+  README.zh.md         # 中文文档
+```
+
+### Running Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+### Building & Publishing
+
+```bash
+pip install build twine
+python -m build
+twine check dist/*
+twine upload dist/*
+```
+
+### Automated Publishing (GitHub Actions)
+
+This project uses a GitHub Actions workflow to automatically publish to PyPI when a new release is created:
+
+1. Bump the version in `pyproject.toml`
+2. Create a new release on GitHub (via the web UI or `gh release create`)
+3. The `publish.yml` workflow will automatically build the package and publish it to PyPI using [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no API token needed)
+
+**Prerequisites**: Configure a [Trusted Publisher](https://docs.pypi.org/trusted-publishers/creating-a-project-through-oidc/) on PyPI for the `ar-book-labels` project, linking it to the `TonyBlur/ar-book-labels` repository and the `pypi` environment.
+
+### Code Style
+
+- Python 3.8+
+- No external dependencies beyond `openpyxl`
+- Keep the generator logic self-contained and testable
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ar_book_labels-0.1.0/ar_book_labels/__init__.py

@@ -0,0 +1,5 @@
+"""ar-book-labels: Generate printable Accelerated Reader book labels from Excel."""
+
+__version__ = "0.1.0"
+
+from ar_book_labels.generator import generate, read_books, build_html

ar_book_labels-0.1.0/ar_book_labels/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m ar_book_labels"""
+
+from ar_book_labels.cli import main
+
+main()

ar_book_labels-0.1.0/ar_book_labels/cli.py

@@ -0,0 +1,126 @@
+"""CLI entry point for ar-book-labels."""
+
+import argparse
+import sys
+from pathlib import Path
+
+from ar_book_labels import __version__
+from ar_book_labels.generator import generate, DEFAULT_COLUMNS
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="ar-book-labels",
+        description="Generate printable Accelerated Reader book labels from an Excel file.",
+    )
+    parser.add_argument("excel", nargs="?", help="Path to the Excel file (.xlsx)")
+    parser.add_argument(
+        "-o", "--output", default="AR_Book_Labels.html",
+        help="Output HTML file path (default: AR_Book_Labels.html)",
+    )
+    parser.add_argument(
+        "-s", "--sheet", default=None,
+        help="Sheet name to read (default: first sheet in the workbook)",
+    )
+    parser.add_argument(
+        "--col-title", default=DEFAULT_COLUMNS["title"],
+        help=f"Excel column name for book title (default: {DEFAULT_COLUMNS['title']})",
+    )
+    parser.add_argument(
+        "--col-author", default=DEFAULT_COLUMNS["author"],
+        help=f"Excel column name for author (default: {DEFAULT_COLUMNS['author']})",
+    )
+    parser.add_argument(
+        "--col-level", default=DEFAULT_COLUMNS["level"],
+        help=f"Excel column name for book level (default: {DEFAULT_COLUMNS['level']})",
+    )
+    parser.add_argument(
+        "--col-points", default=DEFAULT_COLUMNS["points"],
+        help=f"Excel column name for AR points (default: {DEFAULT_COLUMNS['points']})",
+    )
+    parser.add_argument(
+        "--col-quiz", default=DEFAULT_COLUMNS["quiz"],
+        help=f"Excel column name for quiz number (default: {DEFAULT_COLUMNS['quiz']})",
+    )
+    parser.add_argument(
+        "--start-row", type=int, default=2,
+        help="1-indexed row number where data begins (default: 2, i.e. row 1 is header)",
+    )
+    parser.add_argument(
+        "--scale", type=int, default=1,
+        help="Display scale factor for screen preview (default: 1)",
+    )
+    parser.add_argument(
+        "--bw", action="store_true",
+        help="Black-and-white mode: white circle with thin black outline, black level number",
+    )
+    parser.add_argument(
+        "--template", action="store_true",
+        help="Copy the reference Excel template to the current directory and exit",
+    )
+    parser.add_argument(
+        "-V", "--version", action="version", version=f"%(prog)s {__version__}",
+    )
+    args = parser.parse_args()
+
+    if args.template:
+        _copy_template()
+        return
+
+    if not args.excel:
+        parser.error("the following arguments are required: excel")
+
+    excel_path = Path(args.excel)
+    if not excel_path.exists():
+        print(f"Error: file not found: {excel_path}", file=sys.stderr)
+        sys.exit(1)
+
+    output_path = Path(args.output)
+
+    # Build column mapping from CLI args
+    column_mapping = {
+        "title": args.col_title,
+        "author": args.col_author,
+        "level": args.col_level,
+        "points": args.col_points,
+        "quiz": args.col_quiz,
+    }
+
+    try:
+        n_books, n_pages, warnings = generate(
+            excel_path=str(excel_path),
+            output_path=str(output_path),
+            sheet_name=args.sheet,
+            column_mapping=column_mapping,
+            start_row=args.start_row,
+            display_scale=args.scale,
+            bw=args.bw,
+        )
+    except KeyError as e:
+        print(f"Error: sheet not found: {e}", file=sys.stderr)
+        sys.exit(1)
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # Print warnings to stderr
+    for w in warnings:
+        print(f"Warning: {w}", file=sys.stderr)
+
+    if n_books == 0:
+        print("Warning: no books found in the spreadsheet.", file=sys.stderr)
+        sys.exit(0)
+
+    print(f"Generated {n_books} labels ({n_pages} pages) -> {output_path}")
+
+
+def _copy_template():
+    import shutil
+    src = Path(__file__).parent / "templates" / "ar_template.xlsx"
+    dst = Path.cwd() / "ar_template.xlsx"
+    shutil.copy2(src, dst)
+    print(f"Template copied to: {dst}")
+
+
+if __name__ == "__main__":
+    main()

ar_book_labels-0.1.0/ar_book_labels/generator.py

@@ -0,0 +1,327 @@
+"""Core label generation logic."""
+
+import html as html_module
+from pathlib import Path
+
+from openpyxl import load_workbook
+
+# ==================== AR Level Standard Colors ====================
+LEVEL_COLORS = [
+    (0.1, 1.5, "#FFD700"),   # yellow
+    (1.6, 2.0, "#2E8B57"),   # green
+    (2.1, 2.5, "#00008B"),   # dark blue
+    (2.6, 3.0, "#DC143C"),   # red
+    (3.1, 3.5, "#FF69B4"),   # pink
+    (3.6, 4.0, "#800080"),   # purple
+    (4.1, 4.5, "#FF8C00"),   # orange
+    (4.6, 5.0, "#00BFFF"),   # light blue
+    (5.1, 5.5, "#FF6600"),   # neon orange
+    (5.6, 6.0, "#39FF14"),   # neon green
+    (6.1, 6.5, "#1C1C1C"),   # black
+    (6.6, 99.0, "#8B4513"),  # brown
+]
+
+# ==================== SVG Layout Constants ====================
+# Page (A4 portrait, units in mm)
+PAGE_W = 210
+PAGE_H = 297
+
+# Grid: 4 columns x 9 rows = 36 labels per page
+COLS_X = [2, 54, 106, 158]
+ROWS_Y = [13.5, 43.5, 73.5, 103.5, 133.5, 163.5, 193.5, 223.5, 253.5]
+LABEL_W = 50
+LABEL_H = 30
+LABEL_RX = 4
+LABELS_PER_PAGE = len(COLS_X) * len(ROWS_Y)  # 36
+
+FONT = "'Segoe UI', system-ui, -apple-system, 'Helvetica Neue', Arial, sans-serif"
+
+# Default column names (matching the template)
+DEFAULT_COLUMNS = {
+    "title": "AR Title",
+    "author": "AR Author",
+    "level": "Book Level",
+    "points": "AR Points",
+    "quiz": "Quiz Number",
+}
+REQUIRED_FIELDS = ["title", "author", "level", "points", "quiz"]
+
+# Label internal coordinates (50 wide x 30 high, units in mm)
+CX, CY, CR = 11, 18, 6.5       # Badge circle: cx=11, cy=18(下移2), bottom=24.5
+RX = 21                        # Right-side text area x start
+VX = 34                        # Points/Quiz value x (center anchor, 右移4)
+TOP_Y = 4                      # Top text baseline/start y
+AUTHOR_LH = 3.2                # Author line height
+TITLE_LH = 3.6                 # Title line height
+POINTS_Y = 17.2                # Points row (下移2)
+QUIZ_Y = 21.7                  # Quiz row (下移2); bottom ≈ 24.5 = circle bottom
+
+
+def get_level_color(level):
+    try:
+        level = float(level)
+    except (TypeError, ValueError):
+        return "#999999"
+    for low, high, color in LEVEL_COLORS:
+        if low <= level <= high:
+            return color
+    return "#999999"
+
+
+def get_badge_text_color(bg_color):
+    light = {"#FFD700", "#39FF14"}
+    return "#000000" if bg_color in light else "#FFFFFF"
+
+
+def split_text_lines(text, max_chars_per_line):
+    """Wrap text into at most 2 lines; truncate with ellipsis only if >2 lines."""
+    text = str(text).strip()
+    if not text:
+        return [text]
+    if len(text) <= max_chars_per_line:
+        return [text]
+    split_pos = text.rfind(" ", 0, max_chars_per_line)
+    if split_pos == -1:
+        split_pos = max_chars_per_line
+    line1 = text[:split_pos].rstrip()
+    remainder = text[split_pos:].lstrip()
+    if len(remainder) <= max_chars_per_line:
+        return [line1, remainder]
+    return [line1, remainder[:max_chars_per_line - 1].rstrip() + "\u2026"]
+
+
+def read_books(excel_path, sheet_name, columns=None, start_row=2):
+    """Read book data from an Excel file.
+
+    Args:
+        excel_path: Path to the .xlsx file.
+        sheet_name: Name of the sheet to read.
+        columns: Dict mapping internal keys to Excel column names.
+                 Missing keys fall back to DEFAULT_COLUMNS.
+        start_row: 1-indexed row number where data begins (1 = header row).
+
+    Returns:
+        tuple: (books_list, warnings_list)
+    """
+    cols = {**DEFAULT_COLUMNS, **(columns or {})}
+    wb = load_workbook(excel_path, read_only=True, data_only=True)
+    if sheet_name is None:
+        ws = wb.worksheets[0]
+    else:
+        ws = wb[sheet_name]
+    actual_sheet_name = ws.title
+    rows = list(ws.iter_rows(values_only=True))
+    headers = [str(h) for h in rows[0] if h is not None]
+
+    # Check that required columns exist in the sheet
+    missing_cols = []
+    for key in REQUIRED_FIELDS:
+        if cols[key] not in headers:
+            missing_cols.append(f"{key} ('{cols[key]}')")
+    if missing_cols:
+        wb.close()
+        raise ValueError(
+            f"Columns not found in sheet '{actual_sheet_name}': {', '.join(missing_cols)}.\n"
+            f"Available columns: {', '.join(headers)}\n"
+            f"Use --col-* options to map your column names."
+        )
+
+    books = []
+    warnings = []
+    data_rows = rows[start_row - 1:]  # start_row is 1-indexed
+    for i, row in enumerate(data_rows):
+        row_num = start_row + i
+        vals = list(row[:len(headers)])
+        if all(v is None for v in vals):
+            continue
+        raw = dict(zip(headers, vals))
+
+        # Validate required fields
+        missing = []
+        for key in REQUIRED_FIELDS:
+            val = raw.get(cols[key])
+            if val is None or (isinstance(val, str) and not val.strip()):
+                missing.append(cols[key])
+        if missing:
+            warnings.append(f"Row {row_num}: skipped — missing: {', '.join(missing)}")
+            continue
+
+        books.append({
+            "title": raw[cols["title"]],
+            "author": raw[cols["author"]],
+            "level": raw[cols["level"]],
+            "points": raw[cols["points"]],
+            "quiz": raw[cols["quiz"]],
+        })
+
+    wb.close()
+    return books, warnings
+
+
+def _generate_label_svg(book, bw=False):
+    """Generate SVG markup for a single label.
+
+    Args:
+        book: Dict with title, author, level, points, quiz.
+        bw: When True, render in black-and-white mode — white circle with a
+            thin black outline and a black level number. When False (default),
+            use the standard AR color-coded badge.
+
+    Returns:
+        SVG markup string for the label (a ``<g>`` element).
+    """
+    title_raw = book.get("title", "") or ""
+    level = book.get("level", 0)
+    points = str(book.get("points", ""))
+    quiz = str(book.get("quiz", ""))
+
+    level_str = f"{float(level):.1f}" if isinstance(level, (int, float)) else str(level)
+    badge_color = get_level_color(level)
+    badge_text = get_badge_text_color(badge_color)
+
+    # bw mode overrides the badge fill/outline and the level number color.
+    circle_fill = "white" if bw else badge_color
+    circle_stroke = ' stroke="black" stroke-width="0.3"' if bw else ""
+    level_fill = "black" if bw else badge_text
+
+    author_raw = str(book.get("author", "") or "").strip()
+    author_display = html_module.escape(
+        author_raw if len(author_raw) <= 17 else author_raw[:16].rstrip() + "\u2026"
+    )
+    title_lines = [html_module.escape(l) for l in split_text_lines(title_raw, 14)]
+    title_start = TOP_Y + AUTHOR_LH + 0.5
+    title_ys = [title_start + i * TITLE_LH for i in range(len(title_lines))]
+
+    p = []
+    p.append(f'<rect class="label-outline" x="0" y="0" width="{LABEL_W}" height="{LABEL_H}" rx="{LABEL_RX}" fill="none"/>')
+    p.append(f'<circle cx="{CX}" cy="{CY}" r="{CR}" fill="{circle_fill}"{circle_stroke}/>')
+    p.append(f'<text x="{CX}" y="{TOP_Y}" text-anchor="middle" dominant-baseline="hanging" fill="black" font-family="{FONT}" font-size="4.5" font-weight="700" letter-spacing="0.3">ATOS</text>')
+    p.append(f'<text x="{CX}" y="{CY + 2.5}" text-anchor="middle" fill="{level_fill}" font-family="{FONT}" font-size="5.5" font-weight="700">{level_str}</text>')
+    p.append(f'<text x="{RX}" y="{TOP_Y}" dominant-baseline="hanging" fill="#555" font-family="{FONT}" font-size="2.6">{author_display}</text>')
+    for y in title_ys:
+        p.append(f'<text x="{RX}" y="{y}" dominant-baseline="hanging" fill="black" font-family="{FONT}" font-size="3.2" font-weight="600">{title_lines[title_ys.index(y)]}</text>')
+    p.append(f'<text x="{RX}" y="{POINTS_Y}" dominant-baseline="hanging" fill="#666" font-family="{FONT}" font-size="2.5">Points:</text>')
+    p.append(f'<text x="{VX}" y="{POINTS_Y}" text-anchor="middle" dominant-baseline="hanging" fill="black" font-family="{FONT}" font-size="2.8" font-weight="700">{points}</text>')
+    p.append(f'<text x="{RX}" y="{QUIZ_Y}" dominant-baseline="hanging" fill="#666" font-family="{FONT}" font-size="2.5">Quiz:</text>')
+    p.append(f'<text x="{VX}" y="{QUIZ_Y}" text-anchor="middle" dominant-baseline="hanging" fill="black" font-family="{FONT}" font-size="2.8" font-weight="700">{quiz}</text>')
+
+    return "<g>\n  " + "\n  ".join(p) + "\n</g>"
+
+
+def build_html(books, display_scale=1, bw=False):
+    """Build a multi-page HTML document with SVG labels.
+
+    Page dimensions are in millimetres (A4 portrait: 210mm x 297mm) so that
+    printing is 1:1.  On screen, each page is enlarged via CSS ``transform:
+    scale(display_scale)``; ``@media print`` resets the transform to guarantee
+    exact physical dimensions.
+
+    Args:
+        books: List of book dicts.
+        display_scale: Scale factor for screen preview.
+        bw: When True, render labels in black-and-white mode.
+    """
+    pages = []
+    for i in range(0, len(books), LABELS_PER_PAGE):
+        pages.append(books[i:i + LABELS_PER_PAGE])
+
+    s = display_scale
+
+    page_blocks = []
+    for page_idx, page_books in enumerate(pages):
+        labels_svg = ""
+        for i, book in enumerate(page_books):
+            row = i // len(COLS_X)
+            col = i % len(COLS_X)
+            x = COLS_X[col]
+            y = ROWS_Y[row]
+            labels_svg += f'<g transform="translate({x},{y})">{_generate_label_svg(book, bw=bw)}</g>\n'
+
+        pb = ' style="page-break-after: always;"' if page_idx < len(pages) - 1 else ''
+        page_blocks.append(f'''<div class="page"{pb}>
+<svg width="{PAGE_W}mm" height="{PAGE_H}mm" viewBox="0 0 {PAGE_W} {PAGE_H}" xmlns="http://www.w3.org/2000/svg">
+<rect width="{PAGE_W}" height="{PAGE_H}" fill="white"/>
+{labels_svg}
+</svg>
+</div>''')
+
+    return f'''<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<title>AR Book Labels</title>
+<style>
+  @page {{ size: {PAGE_W}mm {PAGE_H}mm; margin: 0; }}
+  * {{ margin: 0; padding: 0; box-sizing: border-box; }}
+  body {{
+    background: #e0e0e0;
+    -webkit-print-color-adjust: exact !important;
+    print-color-adjust: exact !important;
+    color-adjust: exact !important;
+  }}
+  .page {{
+    width: {PAGE_W}mm;
+    height: {PAGE_H}mm;
+    margin: 0 auto;
+    margin-bottom: calc(10px + {PAGE_H}mm * ({s} - 1));
+    background: white;
+    transform: scale({s});
+    transform-origin: top center;
+  }}
+  .page svg {{ display: block; }}
+  .label-outline {{
+    fill: none;
+    stroke: #999999;
+    stroke-width: 0.2;
+    stroke-dasharray: 1.2, 1.2;
+  }}
+  @media print {{
+    body {{ margin: 0; background: white; }}
+    .page {{
+      transform: none;
+      margin: 0 !important;
+      page-break-after: always;
+    }}
+    .page:last-child {{ page-break-after: auto; }}
+    .label-outline {{ stroke: none; }}
+  }}
+</style>
+</head>
+<body>
+{"".join(page_blocks)}
+</body>
+</html>'''
+
+
+def generate(excel_path, output_path, sheet_name=None,
+             column_mapping=None, start_row=2, display_scale=1, bw=False):
+    """High-level entry point: read Excel, generate labels, write HTML.
+
+    Args:
+        excel_path: Path to the .xlsx file.
+        output_path: Output HTML file path.
+        sheet_name: Sheet name to read; None means the first sheet.
+        column_mapping: Optional dict mapping internal keys to Excel column names.
+        start_row: 1-indexed row number where data begins.
+        display_scale: Scale factor for screen preview.
+        bw: When True, render labels in black-and-white mode (white circle,
+            thin black outline, black level number).
+
+    Returns:
+        tuple: (number_of_books, number_of_pages, warnings_list)
+    """
+    books, warnings = read_books(
+        excel_path, sheet_name, columns=column_mapping, start_row=start_row
+    )
+    if not books:
+        html = build_html([], display_scale, bw=bw)
+        with open(output_path, "w", encoding="utf-8") as f:
+            f.write(html)
+        return 0, 0, warnings
+
+    html = build_html(books, display_scale, bw=bw)
+    with open(output_path, "w", encoding="utf-8") as f:
+        f.write(html)
+
+    n_pages = (len(books) + LABELS_PER_PAGE - 1) // LABELS_PER_PAGE
+    return len(books), n_pages, warnings

ar_book_labels-0.1.0/ar_book_labels.egg-info/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: ar-book-labels
+Version: 0.1.0
+Summary: Generate printable Accelerated Reader book labels from an Excel spreadsheet.
+Author: TonyBlur
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/TonyBlur/ar-book-labels
+Project-URL: Issues, https://github.com/TonyBlur/ar-book-labels/issues
+Keywords: accelerated-reader,labels,education,printing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openpyxl>=3.0
+Dynamic: license-file
+
+# ar-book-labels
+
+English | **[简体中文](README.zh.md)**
+
+Generate printable [Accelerated Reader](https://www.renaissance.com/accelerated-reader/) book labels from an Excel spreadsheet. Labels include book title, author, AR level (with standard color coding), points, and quiz number — formatted for sticker-style printing and sticking on books.
+
+## Features
+
+- **Standard AR color coding**: 12 color ranges from yellow (0.1–1.5) to brown (6.6+)
+- **Print-ready HTML output**: 4 columns x 9 rows = 36 labels per page, A4 size, `@page` CSS for direct printing
+- **Smart text truncation**: Titles wrap to 2 lines with ellipsis; authors on 1 line
+- **Author-first layout**: Author name appears above title for easy shelf sorting
+- **Screen preview**: SVG viewBox scaling for crisp browser preview
+- **Template included**: Reference Excel template with sample data and column documentation
+
+## Installation
+
+```bash
+pip install ar-book-labels
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+pip install -e .
+```
+
+## Quick Start
+
+1. **Get the template** (optional — if you don't have an Excel file yet):
+
+```bash
+ar-book-labels --template
+```
+
+This copies `ar_template.xlsx` to your current directory. Fill it with your book data.
+
+2. **Generate labels**:
+
+```bash
+ar-book-labels books.xlsx -o labels.html
+```
+
+3. **Open** `labels.html` in a browser to preview, then print (Ctrl/Cmd+P).
+
+   > **Print tip**: In the browser print dialog, choose **"Actual size"** (or **"No margins"** / **"None"** for margins) to prevent the browser from auto-adding page margins that shift label positions. The HTML already declares `@page { margin: 0 }`; adding browser margins on top causes misalignment.
+
+## CLI Usage
+
+```
+ar-book-labels <excel> [options]
+```
+
+### Arguments
+
+| Argument | Description |
+|----------|-------------|
+| `excel` | Path to the Excel file (.xlsx) |
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-o, --output` | `AR_Book_Labels.html` | Output HTML file path |
+| `-s, --sheet` | first sheet | Sheet name to read (defaults to first sheet) |
+| `--col-title` | `AR Title` | Excel column name for book title |
+| `--col-author` | `AR Author` | Excel column name for author |
+| `--col-level` | `Book Level` | Excel column name for book level |
+| `--col-points` | `AR Points` | Excel column name for AR points |
+| `--col-quiz` | `Quiz Number` | Excel column name for quiz number |
+| `--start-row` | `2` | 1-indexed row where data begins (1 = header row) |
+| `--scale` | `1` | Display scale factor for screen preview |
+| `--bw` | — | Black-and-white mode: white circle with thin black outline, black level number |
+| `--template` | — | Copy the reference Excel template to cwd and exit |
+| `-V, --version` | — | Show version and exit |
+
+### Examples
+
+```bash
+# Basic usage
+ar-book-labels my_books.xlsx
+
+# Custom output path and sheet name
+ar-book-labels my_books.xlsx -o output/labels.html -s "Book Data"
+
+# Custom column names (if your Excel uses different headers)
+ar-book-labels my_books.xlsx --col-title "Title" --col-author "Author Name" --col-level "Level"
+
+# Custom start row (e.g. data starts on row 3)
+ar-book-labels my_books.xlsx --start-row 3
+
+# Copy the template for reference
+ar-book-labels --template
+
+# Black-and-white mode for economical printing
+ar-book-labels my_books.xlsx --bw
+```
+
+## Excel Format
+
+The spreadsheet must contain these columns (default names shown; use `--col-*` options to map custom names):
+
+| Internal Key | Default Column | Type | Description |
+|--------------|----------------|------|-------------|
+| `title` | `AR Title` | text | Book title |
+| `author` | `AR Author` | text | Author name |
+| `level` | `Book Level` | number | AR ATOS level (e.g. 5.1) |
+| `points` | `AR Points` | number | Points value |
+| `quiz` | `Quiz Number` | number/text | Quiz ID |
+
+Rows with missing required fields are skipped with a warning printed to stderr.
+
+Use `ar-book-labels --template` to get a pre-formatted template with sample data.
+
+## AR Level Color Chart
+
+| Level Range | Color | Hex |
+|-------------|-------|-----|
+| 0.1 – 1.5 | Yellow | `#FFD700` |
+| 1.6 – 2.0 | Green | `#2E8B57` |
+| 2.1 – 2.5 | Dark Blue | `#00008B` |
+| 2.6 – 3.0 | Red | `#DC143C` |
+| 3.1 – 3.5 | Pink | `#FF69B4` |
+| 3.6 – 4.0 | Purple | `#800080` |
+| 4.1 – 4.5 | Orange | `#FF8C00` |
+| 4.6 – 5.0 | Light Blue | `#00BFFF` |
+| 5.1 – 5.5 | Neon Orange | `#FF6600` |
+| 5.6 – 6.0 | Neon Green | `#39FF14` |
+| 6.1 – 6.5 | Black | `#1C1C1C` |
+| 6.6+ | Brown | `#8B4513` |
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/TonyBlur/ar-book-labels.git
+cd ar-book-labels
+python -m venv .venv
+source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+pip install -e ".[dev]"
+```
+
+### Project Structure
+
+```
+ar-book-labels/
+  ar_book_labels/
+    __init__.py        # Package metadata and public API
+    generator.py       # Core label generation logic
+    cli.py             # CLI entry point (argparse)
+    __main__.py        # python -m ar_book_labels support
+    templates/
+      ar_template.xlsx # Reference Excel template
+  tests/
+    test_generator.py  # Unit tests
+  pyproject.toml       # Build configuration (setuptools)
+  LICENSE              # MIT License
+  README.md            # This file (English)
+  README.zh.md         # 中文文档
+```
+
+### Running Tests
+
+```bash
+python -m pytest tests/ -v
+```
+
+### Building & Publishing
+
+```bash
+pip install build twine
+python -m build
+twine check dist/*
+twine upload dist/*
+```
+
+### Automated Publishing (GitHub Actions)
+
+This project uses a GitHub Actions workflow to automatically publish to PyPI when a new release is created:
+
+1. Bump the version in `pyproject.toml`
+2. Create a new release on GitHub (via the web UI or `gh release create`)
+3. The `publish.yml` workflow will automatically build the package and publish it to PyPI using [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no API token needed)
+
+**Prerequisites**: Configure a [Trusted Publisher](https://docs.pypi.org/trusted-publishers/creating-a-project-through-oidc/) on PyPI for the `ar-book-labels` project, linking it to the `TonyBlur/ar-book-labels` repository and the `pypi` environment.
+
+### Code Style
+
+- Python 3.8+
+- No external dependencies beyond `openpyxl`
+- Keep the generator logic self-contained and testable
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ar_book_labels-0.1.0/ar_book_labels.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+ar_book_labels/__init__.py
+ar_book_labels/__main__.py
+ar_book_labels/cli.py
+ar_book_labels/generator.py
+ar_book_labels.egg-info/PKG-INFO
+ar_book_labels.egg-info/SOURCES.txt
+ar_book_labels.egg-info/dependency_links.txt
+ar_book_labels.egg-info/entry_points.txt
+ar_book_labels.egg-info/requires.txt
+ar_book_labels.egg-info/top_level.txt
+ar_book_labels/templates/ar_template.xlsx
+tests/test_generator.py

ar_book_labels-0.1.0/ar_book_labels.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ar_book_labels-0.1.0/ar_book_labels.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ar-book-labels = ar_book_labels.cli:main

ar_book_labels-0.1.0/ar_book_labels.egg-info/requires.txt

@@ -0,0 +1 @@
+openpyxl>=3.0

ar_book_labels-0.1.0/ar_book_labels.egg-info/top_level.txt

@@ -0,0 +1 @@
+ar_book_labels

ar_book_labels-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ar-book-labels"
+version = "0.1.0"
+description = "Generate printable Accelerated Reader book labels from an Excel spreadsheet."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "TonyBlur" },
+]
+keywords = ["accelerated-reader", "labels", "education", "printing"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Programming Language :: Python :: 3",
+    "Topic :: Education",
+]
+dependencies = [
+    "openpyxl>=3.0",
+]
+
+[project.scripts]
+ar-book-labels = "ar_book_labels.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/TonyBlur/ar-book-labels"
+Issues = "https://github.com/TonyBlur/ar-book-labels/issues"
+
+[tool.setuptools.packages.find]
+include = ["ar_book_labels*"]
+
+[tool.setuptools.package-data]
+"ar_book_labels" = ["templates/*.xlsx"]

ar_book_labels-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ar_book_labels-0.1.0/tests/test_generator.py

@@ -0,0 +1,98 @@
+"""Tests for ar-book-labels generator."""
+
+from ar_book_labels.generator import (
+    get_level_color,
+    get_badge_text_color,
+    split_text_lines,
+    read_books,
+    build_html,
+    LABELS_PER_PAGE,
+)
+
+
+def test_level_colors():
+    assert get_level_color(1.0) == "#FFD700"  # yellow
+    assert get_level_color(1.8) == "#2E8B57"  # green
+    assert get_level_color(2.3) == "#00008B"  # dark blue
+    assert get_level_color(2.8) == "#DC143C"  # red
+    assert get_level_color(3.3) == "#FF69B4"  # pink
+    assert get_level_color(3.8) == "#800080"  # purple
+    assert get_level_color(4.3) == "#FF8C00"  # orange
+    assert get_level_color(4.8) == "#00BFFF"  # light blue
+    assert get_level_color(5.1) == "#FF6600"  # neon orange
+    assert get_level_color(5.8) == "#39FF14"  # neon green
+    assert get_level_color(6.3) == "#1C1C1C"  # black
+    assert get_level_color(7.0) == "#8B4513"  # brown
+    assert get_level_color(0.0) == "#999999"  # out of range → grey
+    assert get_level_color("invalid") == "#999999"
+
+
+def test_badge_text_color():
+    assert get_badge_text_color("#FFD700") == "#000000"  # yellow → black text
+    assert get_badge_text_color("#39FF14") == "#000000"  # neon green → black text
+    assert get_badge_text_color("#00008B") == "#FFFFFF"  # dark blue → white text
+    assert get_badge_text_color("#1C1C1C") == "#FFFFFF"  # black → white text
+
+
+def test_split_text_lines_single():
+    assert split_text_lines("Short", 19) == ["Short"]
+    assert split_text_lines("", 19) == [""]
+
+
+def test_split_text_lines_wrap():
+    result = split_text_lines("Diary of a Wimpy Kid: The Last Straw", 19)
+    assert len(result) == 2
+    assert result[0] == "Diary of a Wimpy"
+    assert result[1] == "Kid: The Last Straw"
+
+
+def test_split_text_lines_truncate():
+    # This text needs 3 lines at 19 chars, so line 2 gets truncated
+    result = split_text_lines("The Journey to the Center of the Earth is Great", 19)
+    assert len(result) == 2
+    assert result[0] == "The Journey to the"
+    assert result[1].endswith("\u2026")  # ellipsis on truncated line 2
+
+
+def test_split_text_lines_no_space():
+    # Very long single word exceeding 2 lines
+    result = split_text_lines("A" * 50, 19)
+    assert len(result) == 2
+    assert result[1].endswith("\u2026")
+
+
+def test_build_html_empty():
+    html = build_html([])
+    assert "<!DOCTYPE html>" in html
+    assert "AR Book Labels" in html
+    assert "<svg" not in html  # no pages
+
+
+def test_build_html_single_book():
+    book = {
+        "title": "Test Book",
+        "author": "Test Author",
+        "level": 3.5,
+        "points": 5,
+        "quiz": 12345,
+    }
+    html = build_html([book])
+    assert "Test Book" in html
+    assert "Test Author" in html
+    assert "12345" in html
+    assert html.count('<div class="page"') == 1
+
+
+def test_build_html_multi_page():
+    books = [
+        {
+            "title": f"Book {i}",
+            "author": f"Author {i}",
+            "level": 2.0,
+            "points": 1,
+            "quiz": i,
+        }
+        for i in range(LABELS_PER_PAGE + 1)
+    ]
+    html = build_html(books)
+    assert html.count('<div class="page"') == 2