ffs-triumph 0.1.0__tar.gz

ffs_triumph-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check .
+      - name: Test
+        run: pytest -q

ffs_triumph-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+# Publishes on a version tag (e.g. v0.1.0) using PyPI Trusted Publishing (OIDC).
+# One-time setup: on PyPI, add this repo + workflow ("publish.yml") and the
+# "pypi" environment as a Trusted Publisher for the `ffs-triumph` project.
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist + wheel
+        run: |
+          pip install build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write          # required for trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

ffs_triumph-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Secrets
+.env
+
+# Python
+.venv/
+__pycache__/
+*.pyc
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# Local user config (may contain email)
+ffs.toml
+
+# Tool output & caches
+.cache/
+out/
+output/
+output_full/
+*.pdf
+manual.html
+sample.html
+.vscode
+.claude

ffs_triumph-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

ffs_triumph-0.1.0/LICENSE

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

ffs_triumph-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: ffs-triumph
+Version: 0.1.0
+Summary: FFS — Full-manual Fetcher & Stitcher: turn a Triumph service manual into an offline PDF
+Project-URL: Homepage, https://github.com/jerlbaum/ffs-triumph
+Project-URL: Repository, https://github.com/jerlbaum/ffs-triumph
+Project-URL: Issues, https://github.com/jerlbaum/ffs-triumph/issues
+Author-email: Jesse Erlbaum <jesse@erlbaum.net>
+License: MIT
+License-File: LICENSE
+Keywords: motorcycle,offline,pdf,scraper,service-manual,triumph
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: lxml>=5.0
+Requires-Dist: playwright>=1.49
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# FFS — Full-manual Fetcher & Stitcher
+
+*For F***'s Sake, just let me print my own service manual.*
+
+`ffs-triumph` turns a [Triumph Technical Information](https://triumphtechnicalinformation.com)
+service manual — delivered as a JavaScript single-page app you can't download or
+print — into a single, self-contained, **paginated PDF** for offline use.
+
+It logs in with your account, finds your motorcycle from your subscription,
+crawls the whole manual, converts the site's structured content into HTML,
+inlines the diagrams, and renders a clean PDF with a title page, table of
+contents, page numbers, and proper page breaks.
+
+> **Disclaimer.** This tool is for owners with **legitimate, licensed access**
+> archiving **their own** manual for **personal, offline** use. You need a valid
+> Triumph Technical Information subscription; it only ever fetches content your
+> account is already entitled to. It is **not affiliated with or endorsed by
+> Triumph**, and you are responsible for complying with the site's terms of use.
+
+## Install
+
+```bash
+pip install ffs-triumph
+ffs install-browser          # one-time: downloads the Chromium build for PDF rendering
+```
+
+(`install-browser` runs `python -m playwright install chromium`. You can skip it
+if you only use `--html-only`.)
+
+## Quick start
+
+```bash
+# Provide credentials (or you'll be prompted):
+export TTI_EMAIL="you@example.com"
+export TTI_PASSWORD="..."
+
+ffs build out/
+```
+
+That's it. With one motorcycle on your account and one service manual in your
+language, **no other input is needed** — `ffs` auto-detects your VIN from your
+subscription, picks the Service Manual, and writes the PDF to `out/`.
+
+Not sure what's available? Inspect your account first:
+
+```bash
+ffs discover                 # lists your VIN(s), product context, and documents
+```
+
+## How it figures things out
+
+From just your **email + password**:
+
+1. **Your bike** — read from your subscription's VIN(s). One → used automatically;
+   several → you pick from a menu showing year/model. (Override with `--vin`.)
+2. **Product context** — model code/year, serial, engine number and market are
+   looked up from the VIN automatically.
+3. **The manual** — the single `Service Manual` document for your language is
+   selected automatically. Use `--doc-type "Owner Handbook"` for a different type,
+   `--all-types` to browse everything, or `--root-id <id>` to pick exactly.
+
+After a successful run it offers to remember your email + bike + manual in
+`~/.config/ffs-triumph/config.toml` (your password is **never** saved), so the
+next run is just `ffs build out/`.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `ffs build OUTPUT` | Fetch the manual and render `OUTPUT/manual.html` + the PDF |
+| `ffs discover` | List your VIN(s), product context, and available documents |
+| `ffs list` | Print the manual's table of contents with topic IDs |
+| `ffs audit` | Verify every topic fetches with non-empty content |
+| `ffs install-browser` | Download the Chromium build needed for PDF rendering |
+
+### Useful `build` options
+
+| Flag | Purpose |
+|------|---------|
+| `--html-only` | Assemble HTML but skip PDF rendering (no Chromium needed) |
+| `--topic ID` | Only that topic's subtree — fast for previewing |
+| `--limit N` | Render at most N topics |
+| `--inline-images` | Embed images as base64 in one large portable HTML file (default: write to `OUTPUT/images/`; the PDF is self-contained either way) |
+| `--cache-dir DIR` | Where fetched topics/images are cached (default `.cache`) |
+| `--no-cache` | Ignore the cache (still writes it) |
+| `-v` | Verbose progress |
+
+Credentials come from `--email`/`--password`, the `TTI_EMAIL`/`TTI_PASSWORD`
+environment variables, a local `.env`, the saved config, or interactive prompts —
+in that order. Every prompt has a corresponding flag, so the tool is fully
+scriptable / CI-friendly.
+
+## Use as a library
+
+```python
+from ffs_triumph import TriumphClient, ManualConfig
+
+client = TriumphClient("you@example.com", "password")
+vin = client.subscribed_vins()[0]
+client.config = ManualConfig.from_product(client.product_search(vin), root_id="<doc id>")
+root = client.get_root()          # the manual's table-of-contents tree
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

ffs_triumph-0.1.0/README.md

@@ -0,0 +1,106 @@
+# FFS — Full-manual Fetcher & Stitcher
+
+*For F***'s Sake, just let me print my own service manual.*
+
+`ffs-triumph` turns a [Triumph Technical Information](https://triumphtechnicalinformation.com)
+service manual — delivered as a JavaScript single-page app you can't download or
+print — into a single, self-contained, **paginated PDF** for offline use.
+
+It logs in with your account, finds your motorcycle from your subscription,
+crawls the whole manual, converts the site's structured content into HTML,
+inlines the diagrams, and renders a clean PDF with a title page, table of
+contents, page numbers, and proper page breaks.
+
+> **Disclaimer.** This tool is for owners with **legitimate, licensed access**
+> archiving **their own** manual for **personal, offline** use. You need a valid
+> Triumph Technical Information subscription; it only ever fetches content your
+> account is already entitled to. It is **not affiliated with or endorsed by
+> Triumph**, and you are responsible for complying with the site's terms of use.
+
+## Install
+
+```bash
+pip install ffs-triumph
+ffs install-browser          # one-time: downloads the Chromium build for PDF rendering
+```
+
+(`install-browser` runs `python -m playwright install chromium`. You can skip it
+if you only use `--html-only`.)
+
+## Quick start
+
+```bash
+# Provide credentials (or you'll be prompted):
+export TTI_EMAIL="you@example.com"
+export TTI_PASSWORD="..."
+
+ffs build out/
+```
+
+That's it. With one motorcycle on your account and one service manual in your
+language, **no other input is needed** — `ffs` auto-detects your VIN from your
+subscription, picks the Service Manual, and writes the PDF to `out/`.
+
+Not sure what's available? Inspect your account first:
+
+```bash
+ffs discover                 # lists your VIN(s), product context, and documents
+```
+
+## How it figures things out
+
+From just your **email + password**:
+
+1. **Your bike** — read from your subscription's VIN(s). One → used automatically;
+   several → you pick from a menu showing year/model. (Override with `--vin`.)
+2. **Product context** — model code/year, serial, engine number and market are
+   looked up from the VIN automatically.
+3. **The manual** — the single `Service Manual` document for your language is
+   selected automatically. Use `--doc-type "Owner Handbook"` for a different type,
+   `--all-types` to browse everything, or `--root-id <id>` to pick exactly.
+
+After a successful run it offers to remember your email + bike + manual in
+`~/.config/ffs-triumph/config.toml` (your password is **never** saved), so the
+next run is just `ffs build out/`.
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `ffs build OUTPUT` | Fetch the manual and render `OUTPUT/manual.html` + the PDF |
+| `ffs discover` | List your VIN(s), product context, and available documents |
+| `ffs list` | Print the manual's table of contents with topic IDs |
+| `ffs audit` | Verify every topic fetches with non-empty content |
+| `ffs install-browser` | Download the Chromium build needed for PDF rendering |
+
+### Useful `build` options
+
+| Flag | Purpose |
+|------|---------|
+| `--html-only` | Assemble HTML but skip PDF rendering (no Chromium needed) |
+| `--topic ID` | Only that topic's subtree — fast for previewing |
+| `--limit N` | Render at most N topics |
+| `--inline-images` | Embed images as base64 in one large portable HTML file (default: write to `OUTPUT/images/`; the PDF is self-contained either way) |
+| `--cache-dir DIR` | Where fetched topics/images are cached (default `.cache`) |
+| `--no-cache` | Ignore the cache (still writes it) |
+| `-v` | Verbose progress |
+
+Credentials come from `--email`/`--password`, the `TTI_EMAIL`/`TTI_PASSWORD`
+environment variables, a local `.env`, the saved config, or interactive prompts —
+in that order. Every prompt has a corresponding flag, so the tool is fully
+scriptable / CI-friendly.
+
+## Use as a library
+
+```python
+from ffs_triumph import TriumphClient, ManualConfig
+
+client = TriumphClient("you@example.com", "password")
+vin = client.subscribed_vins()[0]
+client.config = ManualConfig.from_product(client.product_search(vin), root_id="<doc id>")
+root = client.get_root()          # the manual's table-of-contents tree
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

ffs_triumph-0.1.0/fit_for_print.js

@@ -0,0 +1,13 @@
+/*
+
+Modify the DOM so that we can print it.
+
+https://triumphtechnicalinformation.com/document/690d9a07cf4323000922e147?topics=5908801803,5814189963&active=1
+
+*/
+
+var jq = document.createElement('script');
+jq.src = "https://code.jquery.com/jquery-3.7.1.min.js"; // Use a specific, recent version
+document.getElementsByTagName('head')[0].appendChild(jq);
+
+// Remove watermark div

ffs_triumph-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ffs-triumph"
+dynamic = ["version"]
+description = "FFS — Full-manual Fetcher & Stitcher: turn a Triumph service manual into an offline PDF"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Jesse Erlbaum", email = "jesse@erlbaum.net" }]
+keywords = ["triumph", "motorcycle", "service-manual", "pdf", "offline", "scraper"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "beautifulsoup4>=4.12",
+    "lxml>=5.0",
+    "playwright>=1.49",
+    "requests>=2.31",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "ruff>=0.6"]
+
+[project.urls]
+Homepage = "https://github.com/jerlbaum/ffs-triumph"
+Repository = "https://github.com/jerlbaum/ffs-triumph"
+Issues = "https://github.com/jerlbaum/ffs-triumph/issues"
+
+[project.scripts]
+ffs = "ffs_triumph.cli:main"
+
+[tool.hatch.version]
+path = "src/ffs_triumph/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ffs_triumph"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

ffs_triumph-0.1.0/src/ffs_triumph/__init__.py

@@ -0,0 +1,13 @@
+"""FFS — Full-manual Fetcher & Stitcher.
+
+Turn a Triumph Technical Information service manual (a JavaScript SPA) into a
+single, self-contained, paginated PDF for offline viewing and printing.
+"""
+
+__version__ = "0.1.0"
+
+from .client import LoginError, TriumphClient
+from .config import ManualConfig
+from .render import HtmlRenderer
+
+__all__ = ["TriumphClient", "LoginError", "ManualConfig", "HtmlRenderer", "__version__"]

ffs_triumph-0.1.0/src/ffs_triumph/__main__.py

@@ -0,0 +1,6 @@
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())