bookstack-file-exporter 2.0.0__tar.gz → 2.2.0__tar.gz

{bookstack_file_exporter-2.0.0/bookstack_file_exporter.egg-info → bookstack_file_exporter-2.2.0}/PKG-INFO

@@ -1,28 +1,23 @@
 Metadata-Version: 2.4
 Name: bookstack-file-exporter
-Version: 2.0.0
+Version: 2.2.0
 Summary: An exporter written in python to export all documents from a bookstack instance in different formats
-Home-page: https://github.com/homeylab/bookstack-file-exporter
 Author: pchang388
 License: MIT License
+Project-URL: Homepage, https://github.com/homeylab/bookstack-file-exporter
 Keywords: bookstack,exporter
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Pyyaml>=6.0.2
+Requires-Dist: Pyyaml>=6.0.3
 Requires-Dist: Pydantic>=2.13.4
 Requires-Dist: beautifulsoup4>=4.14.3
-Requires-Dist: requests>=2.32.3
-Requires-Dist: minio>=7.2.15
-Requires-Dist: apprise>=1.9.4
-Requires-Dist: markdown-it-py>=3.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Requires-Dist: responses>=0.25; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
+Requires-Dist: requests>=2.34.2
+Requires-Dist: minio>=7.2.20
+Requires-Dist: apprise>=1.10.0
+Requires-Dist: markdown-it-py>=4.2.0
 Dynamic: license-file
 
 # bookstack-file-exporter
@@ -53,7 +48,7 @@ Table of Contents
 ## Background
 _If you encounter any issues, want to request an additional feature, or provide assistance, feel free to open a Github issue._
 
-This tool provides a way to export [Bookstack](https://github.com/BookStackApp/BookStack) pages and their content (_text, images, attachments, metadata, etc._) into a relational parent-child layout locally with an option to push to remote object storage locations. See [Backup Behavior](#backup-behavior) section for more details on how pages are organized. Image and attachment links can also be modified in markdown exports to point to local exported paths.
+This tool provides a way to export [Bookstack](https://github.com/BookStackApp/BookStack) pages and their content (_text, images, attachments, metadata, etc._) into a relational parent-child layout locally with an option to push to remote object storage locations. See [Backup Behavior](#backup-behavior) section for more details on how pages are organized. Image and attachment links can also be modified in markdown and html exports to point to local exported paths.
 
 This small project was mainly created to run as a cron job in k8s but works anywhere. This tool allows me to export my docs in markdown, or other formats like pdf. I use Bookstack's markdown editor as default instead of WYSIWYG editor and this makes my notes portable anywhere even if offline.
 
@@ -118,15 +113,18 @@ assets:
 ```
 
 ### Run via Pip
-The exporter can be installed via pip and run directly.
+The exporter can be installed via pip (or [uv](https://docs.astral.sh/uv/)) and run directly.
 
 #### Python Version
-_Note: This application is tested and developed on Python version `3.13.2`. The min required version is >= `3.8` but is recommended to install (or set up a venv) a `3.13.2` version._
+_Note: This application is tested and developed on Python version `3.14.5`. The min required version is >= `3.11` but is recommended to install (or set up a venv) a `3.14.5` version._
 
 #### Examples
 ```bash
 python -m pip install bookstack-file-exporter
 
+# or with uv:
+uv pip install bookstack-file-exporter
+
 # if you prefer a specific version, example:
 python -m pip install bookstack-file-exporter==X.X.X
 
@@ -306,13 +304,14 @@ More descriptions can be found for each section below:
 | `credentials` | `object` | `false` | Optional section where Bookstack tokenId and tokenSecret can be specified. Env variable for credentials may be supplied instead. See [Authentication](#authentication) for more details. |
 | `credentials.token_id` | `str`| `false` if specified through env var instead, otherwise `true` | A valid Bookstack tokenId. |
 | `credentials.token_secret` | `str` | `false` if specified through env var instead, otherwise `true` | A valid Bookstack tokenSecret. |
-| `formats` | `list<str>` | `true` | Which export formats to use for Bookstack page content. Valid options are: `["markdown", "html", "pdf", "plaintext", "zip"]`|
+| `formats` | `list<str>` | `true` | Which export formats to use for BookStack content. Valid options are: `["markdown", "html", "pdf", "plaintext", "zip"]`|
+| `export_level` | `str` | `false` | Optional (default: `pages`). Export granularity. See [Export Level](#export-level) for details. Valid options: `pages`, `books`, `chapters`. |
 | `output_path` | `str` | `false` | Optional (default: `cwd`) which directory (relative or full path) to place exports. User who runs the command should have access to read/write to this directory. This directory and any parent directories will be attempted to be created if they do not exist. If not provided, will use current run directory by default. If using docker, this option can be omitted. |
 | `assets` | `object` | `false` | Optional section to export additional assets from pages. |
 | `assets.export_images` | `bool` | `false` | Optional (default: `false`), export all images for a page to an `image` directory within page directory. See [Backup Behavior](#backup-behavior) for more information on layout |
 | `assets.export_attachments` | `bool` | `false` | Optional (default: `false`), export all attachments for a page to an `attachments` directory within page directory. See [Backup Behavior](#backup-behavior) for more information on layout |
 | `assets.modify_links` | `bool` | `false` | Optional (default: `false`). Rewrites image and attachment URLs in markdown AND html exports to local relative paths. Requires `assets.export_images` and/or `assets.export_attachments` to be `true`. Only applies to `markdown` and `html` formats; pdf, plaintext, and zip are not eligible. Legacy key `modify_markdown` still accepted (deprecated); will be removed in a future version. See [Modify Links](#modify-links) for more information. |
-| `assets.export_meta` | `bool` | `false` | Optional (default: `false`), export of metadata about the page in a json file. |
+| `assets.export_meta` | `bool` | `false` | Optional (default: `false`), export metadata about each archived page, book, or chapter in a json file. |
 | `http_config` | `object` | `false` | Optional section to override default http configuration. |
 | `http_config.verify_ssl` | `bool` | `false` | Optional (default: `false`), whether or not to verify ssl certificates if using https. |
 | `http_config.timeout` | `int` | `false` | Optional (default: `30`), set the timeout, in seconds, for http requests. |
@@ -337,6 +336,26 @@ General
 - `MINIO_ACCESS_KEY`
 - `MINIO_SECRET_KEY`
 
+## Export Level
+
+The `export_level` configuration option controls the granularity of exports:
+
+| Value | Description |
+| ----- | ----------- |
+| `pages` (default) | One file per page. Supports `assets.export_images`, `assets.export_attachments`, and `assets.modify_links`. |
+| `books` | One combined file per book per format, written to a per-book folder (`<shelf>/<book>/<book>.<ext>`). Set `assets.modify_links: true` (with `export_images`/`export_attachments`) to download images/attachments locally and rewrite links to relative paths in `markdown` and `html`. `pdf` stays self-contained (assets embedded by Bookstack server-side). |
+| `chapters` | One combined file per chapter per format, in a per-chapter folder (`<shelf>/<book>/<chapter>/<chapter>.<ext>`). Same `modify_links` support (markdown + html) as `books`. **Note:** pages not under any chapter are not captured at this level. |
+
+**Example:** `formats: [pdf]` + `export_level: books` exports one PDF per book through the server-side BookStack API export.
+
+**Empty nodes:** At `books` and `chapters` levels, a book or chapter with no child content is skipped — no file is written and the omission is logged at `INFO`. This keeps the archive free of empty placeholder documents.
+
+The shelf/book/chapter hierarchy is preserved as directories inside the archive regardless of level — e.g. `books` produces `<shelf>/<book>/<book>.pdf` and `chapters` produces `<shelf>/<book>/<chapter>/<chapter>.pdf` (books without a shelf go under the unassigned directory).
+
+`assets.export_meta` applies at all levels: when enabled, a `_meta.json` file is written alongside each exported node.
+
+For non-default levels the archive filename is suffixed with the level (e.g. `bkps_books_<timestamp>.tgz`, `bkps_chapters_<timestamp>.tgz`); `pages` keeps the unsuffixed `bkps_<timestamp>.tgz`. Because `keep_last` cleanup matches on this prefix, archive retention is scoped independently per level.
+
 ## Backup Behavior
 
 ### General
@@ -477,7 +496,7 @@ If an API call to get an attachment or its metadata fails, the exporter will ski
 
 The configuration item, `assets.modify_links`, can be set to `true` to rewrite image and attachment URL links in exported files to local relative paths. This feature makes your `markdown` and `html` exports fully portable — assets resolve locally without a network connection to the Bookstack instance.
 
-- **Eligible formats**: `markdown` and `html` only. PDF, plaintext, and zip exports are not rewritten.
+- **Eligible formats**: `markdown` and `html` only. PDF, plaintext, and zip exports are not yet requested/implemented.
 - **Scope**: rewrites image `src` attributes and their outer anchor `href` wrappers; rewrites attachment `<a href>` links. Does **not** rewrite inter-page, inter-book, inter-chapter, or inter-shelf links (deferred to a future issue).
 - **Legacy alias**: the old key `modify_markdown` will be removed in a future version. Rename to `modify_links` in your configuration.
 
@@ -495,20 +514,31 @@ Page (parent) -> Images (children) relationships are created and then each image
 
 #### HTML example
 
-Bookstack HTML exports wrap images in an anchor tag (click-to-zoom). Both the `<img src>` and the outer `<a href>` are rewritten to the same local file.
+Bookstack HTML exports wrap images in an anchor tag (click-to-zoom). Both the
+`<img src>` and the outer `<a href>` are rewritten to the same local file.
+Images appear in one of two forms; both are localized:
 
 ```html
-<!-- before: anchor-wrapped image -->
+<!-- before: remote "scaled" thumbnail src (older bookstack installations) -->
+<a href="https://demo.bookstack/uploads/images/gallery/2023-07/pool-topology-1.png">
+  <img src="https://demo.bookstack/uploads/images/gallery/2023-07/scaled-1680-/pool-topology-1.png">
+</a>
+
+<!-- before: inline base64 src (recent bookstack installations) -->
 <a href="https://demo.bookstack/uploads/images/gallery/2023-07/pool-topology-1.png">
   <img src="data:image/png;base64,...">
 </a>
 
-<!-- after -->
+<!-- after (both forms): src and href point at the one local file -->
 <a href="images/{page_name}/pool-topology-1.png">
-  <img src="data:image/png;base64,...">
+  <img src="images/{page_name}/pool-topology-1.png">
 </a>
 ```
 
+Inline base64 images are de-inlined to the local file (shrinking the export by
+up to ~700 KB per full-size image). A base64 image **not** wrapped in a
+downloadable anchor is left inline (it still resolves offline).
+
 Attachment links are rewritten from the live URL to a local relative path.
 
 ```html
@@ -523,7 +553,7 @@ Attachment links are rewritten from the live URL to a local relative path.
 
 Markdown exports use raw `bytes.replace` — no structural awareness (e.g. DOM). If an attachment URL for some reason appears verbatim anywhere in the markdown source (code block, pre, comment, plain text), it gets replaced.
 
-HTML exports are safe because bs4 filters to only <img src> / <a href> attributes before replacing.
+HTML exports are safe because bs4 filters to only `<img src> / <a href>` attributes before replacing.
 
 ## Object Storage
 Optionally, target(s) can be specified to upload generated archives to a remote location. Supported object storage providers can be found below:
@@ -614,24 +644,30 @@ Below are versions that have major changes to the way configuration or exporter
 
 ## Running Tests
 
-Install dev dependencies and run the test suite:
+This project uses [uv](https://docs.astral.sh/uv/) for development. Sync dev dependencies and run the test suite:
+
+```bash
+uv sync --all-groups
+uv run pytest
+```
+
+Or via the [Taskfile](https://taskfile.dev) target:
 
 ```bash
-pip install -e ".[dev]"
-pytest
+task test
 ```
 
 The pytest run includes coverage by default (configured in `pyproject.toml`). For an HTML coverage report:
 
 ```bash
-pytest --cov-report=html
+uv run pytest --cov-report=html
 open htmlcov/index.html
 ```
 
 To run only unit tests (skipping integration tests):
 
 ```bash
-pytest tests/unit
+uv run pytest tests/unit
 ```
 
 To run only the integration tests:

bookstack_file_exporter-2.0.0/PKG-INFO → bookstack_file_exporter-2.2.0/README.md

@@ -1,30 +1,3 @@
-Metadata-Version: 2.4
-Name: bookstack-file-exporter
-Version: 2.0.0
-Summary: An exporter written in python to export all documents from a bookstack instance in different formats
-Home-page: https://github.com/homeylab/bookstack-file-exporter
-Author: pchang388
-License: MIT License
-Keywords: bookstack,exporter
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: Pyyaml>=6.0.2
-Requires-Dist: Pydantic>=2.13.4
-Requires-Dist: beautifulsoup4>=4.14.3
-Requires-Dist: requests>=2.32.3
-Requires-Dist: minio>=7.2.15
-Requires-Dist: apprise>=1.9.4
-Requires-Dist: markdown-it-py>=3.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-cov>=5.0; extra == "dev"
-Requires-Dist: responses>=0.25; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Dynamic: license-file
-
 # bookstack-file-exporter
 Table of Contents
 - [bookstack-file-exporter](#bookstack-file-exporter)
@@ -53,7 +26,7 @@ Table of Contents
 ## Background
 _If you encounter any issues, want to request an additional feature, or provide assistance, feel free to open a Github issue._
 
-This tool provides a way to export [Bookstack](https://github.com/BookStackApp/BookStack) pages and their content (_text, images, attachments, metadata, etc._) into a relational parent-child layout locally with an option to push to remote object storage locations. See [Backup Behavior](#backup-behavior) section for more details on how pages are organized. Image and attachment links can also be modified in markdown exports to point to local exported paths.
+This tool provides a way to export [Bookstack](https://github.com/BookStackApp/BookStack) pages and their content (_text, images, attachments, metadata, etc._) into a relational parent-child layout locally with an option to push to remote object storage locations. See [Backup Behavior](#backup-behavior) section for more details on how pages are organized. Image and attachment links can also be modified in markdown and html exports to point to local exported paths.
 
 This small project was mainly created to run as a cron job in k8s but works anywhere. This tool allows me to export my docs in markdown, or other formats like pdf. I use Bookstack's markdown editor as default instead of WYSIWYG editor and this makes my notes portable anywhere even if offline.
 
@@ -118,15 +91,18 @@ assets:
 ```
 
 ### Run via Pip
-The exporter can be installed via pip and run directly.
+The exporter can be installed via pip (or [uv](https://docs.astral.sh/uv/)) and run directly.
 
 #### Python Version
-_Note: This application is tested and developed on Python version `3.13.2`. The min required version is >= `3.8` but is recommended to install (or set up a venv) a `3.13.2` version._
+_Note: This application is tested and developed on Python version `3.14.5`. The min required version is >= `3.11` but is recommended to install (or set up a venv) a `3.14.5` version._
 
 #### Examples
 ```bash
 python -m pip install bookstack-file-exporter
 
+# or with uv:
+uv pip install bookstack-file-exporter
+
 # if you prefer a specific version, example:
 python -m pip install bookstack-file-exporter==X.X.X
 
@@ -306,13 +282,14 @@ More descriptions can be found for each section below:
 | `credentials` | `object` | `false` | Optional section where Bookstack tokenId and tokenSecret can be specified. Env variable for credentials may be supplied instead. See [Authentication](#authentication) for more details. |
 | `credentials.token_id` | `str`| `false` if specified through env var instead, otherwise `true` | A valid Bookstack tokenId. |
 | `credentials.token_secret` | `str` | `false` if specified through env var instead, otherwise `true` | A valid Bookstack tokenSecret. |
-| `formats` | `list<str>` | `true` | Which export formats to use for Bookstack page content. Valid options are: `["markdown", "html", "pdf", "plaintext", "zip"]`|
+| `formats` | `list<str>` | `true` | Which export formats to use for BookStack content. Valid options are: `["markdown", "html", "pdf", "plaintext", "zip"]`|
+| `export_level` | `str` | `false` | Optional (default: `pages`). Export granularity. See [Export Level](#export-level) for details. Valid options: `pages`, `books`, `chapters`. |
 | `output_path` | `str` | `false` | Optional (default: `cwd`) which directory (relative or full path) to place exports. User who runs the command should have access to read/write to this directory. This directory and any parent directories will be attempted to be created if they do not exist. If not provided, will use current run directory by default. If using docker, this option can be omitted. |
 | `assets` | `object` | `false` | Optional section to export additional assets from pages. |
 | `assets.export_images` | `bool` | `false` | Optional (default: `false`), export all images for a page to an `image` directory within page directory. See [Backup Behavior](#backup-behavior) for more information on layout |
 | `assets.export_attachments` | `bool` | `false` | Optional (default: `false`), export all attachments for a page to an `attachments` directory within page directory. See [Backup Behavior](#backup-behavior) for more information on layout |
 | `assets.modify_links` | `bool` | `false` | Optional (default: `false`). Rewrites image and attachment URLs in markdown AND html exports to local relative paths. Requires `assets.export_images` and/or `assets.export_attachments` to be `true`. Only applies to `markdown` and `html` formats; pdf, plaintext, and zip are not eligible. Legacy key `modify_markdown` still accepted (deprecated); will be removed in a future version. See [Modify Links](#modify-links) for more information. |
-| `assets.export_meta` | `bool` | `false` | Optional (default: `false`), export of metadata about the page in a json file. |
+| `assets.export_meta` | `bool` | `false` | Optional (default: `false`), export metadata about each archived page, book, or chapter in a json file. |
 | `http_config` | `object` | `false` | Optional section to override default http configuration. |
 | `http_config.verify_ssl` | `bool` | `false` | Optional (default: `false`), whether or not to verify ssl certificates if using https. |
 | `http_config.timeout` | `int` | `false` | Optional (default: `30`), set the timeout, in seconds, for http requests. |
@@ -337,6 +314,26 @@ General
 - `MINIO_ACCESS_KEY`
 - `MINIO_SECRET_KEY`
 
+## Export Level
+
+The `export_level` configuration option controls the granularity of exports:
+
+| Value | Description |
+| ----- | ----------- |
+| `pages` (default) | One file per page. Supports `assets.export_images`, `assets.export_attachments`, and `assets.modify_links`. |
+| `books` | One combined file per book per format, written to a per-book folder (`<shelf>/<book>/<book>.<ext>`). Set `assets.modify_links: true` (with `export_images`/`export_attachments`) to download images/attachments locally and rewrite links to relative paths in `markdown` and `html`. `pdf` stays self-contained (assets embedded by Bookstack server-side). |
+| `chapters` | One combined file per chapter per format, in a per-chapter folder (`<shelf>/<book>/<chapter>/<chapter>.<ext>`). Same `modify_links` support (markdown + html) as `books`. **Note:** pages not under any chapter are not captured at this level. |
+
+**Example:** `formats: [pdf]` + `export_level: books` exports one PDF per book through the server-side BookStack API export.
+
+**Empty nodes:** At `books` and `chapters` levels, a book or chapter with no child content is skipped — no file is written and the omission is logged at `INFO`. This keeps the archive free of empty placeholder documents.
+
+The shelf/book/chapter hierarchy is preserved as directories inside the archive regardless of level — e.g. `books` produces `<shelf>/<book>/<book>.pdf` and `chapters` produces `<shelf>/<book>/<chapter>/<chapter>.pdf` (books without a shelf go under the unassigned directory).
+
+`assets.export_meta` applies at all levels: when enabled, a `_meta.json` file is written alongside each exported node.
+
+For non-default levels the archive filename is suffixed with the level (e.g. `bkps_books_<timestamp>.tgz`, `bkps_chapters_<timestamp>.tgz`); `pages` keeps the unsuffixed `bkps_<timestamp>.tgz`. Because `keep_last` cleanup matches on this prefix, archive retention is scoped independently per level.
+
 ## Backup Behavior
 
 ### General
@@ -477,7 +474,7 @@ If an API call to get an attachment or its metadata fails, the exporter will ski
 
 The configuration item, `assets.modify_links`, can be set to `true` to rewrite image and attachment URL links in exported files to local relative paths. This feature makes your `markdown` and `html` exports fully portable — assets resolve locally without a network connection to the Bookstack instance.
 
-- **Eligible formats**: `markdown` and `html` only. PDF, plaintext, and zip exports are not rewritten.
+- **Eligible formats**: `markdown` and `html` only. PDF, plaintext, and zip exports are not yet requested/implemented.
 - **Scope**: rewrites image `src` attributes and their outer anchor `href` wrappers; rewrites attachment `<a href>` links. Does **not** rewrite inter-page, inter-book, inter-chapter, or inter-shelf links (deferred to a future issue).
 - **Legacy alias**: the old key `modify_markdown` will be removed in a future version. Rename to `modify_links` in your configuration.
 
@@ -495,20 +492,31 @@ Page (parent) -> Images (children) relationships are created and then each image
 
 #### HTML example
 
-Bookstack HTML exports wrap images in an anchor tag (click-to-zoom). Both the `<img src>` and the outer `<a href>` are rewritten to the same local file.
+Bookstack HTML exports wrap images in an anchor tag (click-to-zoom). Both the
+`<img src>` and the outer `<a href>` are rewritten to the same local file.
+Images appear in one of two forms; both are localized:
 
 ```html
-<!-- before: anchor-wrapped image -->
+<!-- before: remote "scaled" thumbnail src (older bookstack installations) -->
+<a href="https://demo.bookstack/uploads/images/gallery/2023-07/pool-topology-1.png">
+  <img src="https://demo.bookstack/uploads/images/gallery/2023-07/scaled-1680-/pool-topology-1.png">
+</a>
+
+<!-- before: inline base64 src (recent bookstack installations) -->
 <a href="https://demo.bookstack/uploads/images/gallery/2023-07/pool-topology-1.png">
   <img src="data:image/png;base64,...">
 </a>
 
-<!-- after -->
+<!-- after (both forms): src and href point at the one local file -->
 <a href="images/{page_name}/pool-topology-1.png">
-  <img src="data:image/png;base64,...">
+  <img src="images/{page_name}/pool-topology-1.png">
 </a>
 ```
 
+Inline base64 images are de-inlined to the local file (shrinking the export by
+up to ~700 KB per full-size image). A base64 image **not** wrapped in a
+downloadable anchor is left inline (it still resolves offline).
+
 Attachment links are rewritten from the live URL to a local relative path.
 
 ```html
@@ -523,7 +531,7 @@ Attachment links are rewritten from the live URL to a local relative path.
 
 Markdown exports use raw `bytes.replace` — no structural awareness (e.g. DOM). If an attachment URL for some reason appears verbatim anywhere in the markdown source (code block, pre, comment, plain text), it gets replaced.
 
-HTML exports are safe because bs4 filters to only <img src> / <a href> attributes before replacing.
+HTML exports are safe because bs4 filters to only `<img src> / <a href>` attributes before replacing.
 
 ## Object Storage
 Optionally, target(s) can be specified to upload generated archives to a remote location. Supported object storage providers can be found below:
@@ -614,24 +622,30 @@ Below are versions that have major changes to the way configuration or exporter
 
 ## Running Tests
 
-Install dev dependencies and run the test suite:
+This project uses [uv](https://docs.astral.sh/uv/) for development. Sync dev dependencies and run the test suite:
+
+```bash
+uv sync --all-groups
+uv run pytest
+```
+
+Or via the [Taskfile](https://taskfile.dev) target:
 
 ```bash
-pip install -e ".[dev]"
-pytest
+task test
 ```
 
 The pytest run includes coverage by default (configured in `pyproject.toml`). For an HTML coverage report:
 
 ```bash
-pytest --cov-report=html
+uv run pytest --cov-report=html
 open htmlcov/index.html
 ```
 
 To run only unit tests (skipping integration tests):
 
 ```bash
-pytest tests/unit
+uv run pytest tests/unit
 ```
 
 To run only the integration tests:

{bookstack_file_exporter-2.0.0 → bookstack_file_exporter-2.2.0}/bookstack_file_exporter/archiver/archiver.py

@@ -1,11 +1,15 @@
-from typing import List, Dict
 from datetime import datetime
 import logging
 import os
 
 from bookstack_file_exporter.exporter.node import Node
 from bookstack_file_exporter.archiver import util
-from bookstack_file_exporter.archiver.page_archiver import PageArchiver
+from bookstack_file_exporter.archiver.node_archiver import (
+    NodeArchiver,
+    BookArchiver,
+    ChapterArchiver,
+    PageArchiver,
+)
 from bookstack_file_exporter.archiver.minio_archiver import MinioArchiver
 from bookstack_file_exporter.config_helper.remote import StorageProviderConfig
 from bookstack_file_exporter.config_helper.config_helper import ConfigNode
@@ -18,7 +22,7 @@ _DATE_STR_FORMAT = "%Y-%m-%d_%H-%M-%S"
 # pylint: disable=too-many-instance-attributes
 class Archiver:
     """
-    Archiver helps handle archive duties: pulls all the necessary files from upstream 
+    Archiver helps handle archive duties: pulls all the necessary files from upstream
     and then pushes them to the specified backup location(s)
 
     Args:
@@ -26,15 +30,41 @@ class Archiver:
         :http_client: <HttpHelper> = http helper functions with config from user inputs
 
     Returns:
-        Archiver instance with attributes that are accessible 
+        Archiver instance with attributes that are accessible
         for use for handling bookstack exports and remote uploads.
     """
     def __init__(self, config: ConfigNode, http_client: HttpHelper):
         self.config = config
         # for convenience
-        self.base_dir = config.base_dir_name
+        self.base_dir = self._level_base_dir(config.base_dir_name,
+                                             config.user_inputs.export_level)
         self.archive_dir = self._generate_root_folder(self.base_dir)
-        self._page_archiver = PageArchiver(self.archive_dir, self.config, http_client)
+        self._archiver: NodeArchiver = self._build_archiver(http_client)
+
+    def _build_archiver(self, http_client: HttpHelper) -> NodeArchiver:
+        """Return the appropriate archiver based on the configured export level."""
+        export_level = self.config.user_inputs.export_level
+        export_meta: bool = self.config.user_inputs.assets.export_meta
+        if export_level == "books":
+            return BookArchiver(
+                archive_dir=self.archive_dir,
+                api_urls=self.config.urls,
+                export_formats=self.config.user_inputs.formats,
+                http_client=http_client,
+                export_meta=export_meta,
+                asset_config=self.config.user_inputs.assets,
+            )
+        if export_level == "chapters":
+            return ChapterArchiver(
+                archive_dir=self.archive_dir,
+                api_urls=self.config.urls,
+                export_formats=self.config.user_inputs.formats,
+                http_client=http_client,
+                export_meta=export_meta,
+                asset_config=self.config.user_inputs.assets,
+            )
+        # default: "pages"
+        return PageArchiver(self.archive_dir, self.config, http_client)
 
     def create_export_dir(self):
         """create directory for archiving"""
@@ -52,17 +82,23 @@ class Archiver:
                         "attempting to skip this step")
             return
 
-    def get_bookstack_exports(self, page_nodes: Dict[int, Node]):
-        """export all page content"""
-        log.info("Exporting all bookstack page contents")
-        # get images first if requested
-        # this is because we may want to manipulate page data with modify_links flag
-        self._page_archiver.archive_pages(page_nodes)
+    def get_bookstack_exports(self, nodes: dict[int, Node]):
+        """export all node content (polymorphic: pages, books, or chapters)"""
+        log.info("Exporting all bookstack contents")
+        self._archiver.archive(nodes)
+
+    @property
+    def has_exported_content(self) -> bool:
+        """True if the intermediate tar exists, i.e. at least one file was written.
+
+        Checked against the tar on disk (ground truth) rather than a flag threaded
+        up from the archivers, so it cannot drift from what was actually archived.
+        """
+        return os.path.exists(self._archiver.tar_file)
 
     def create_archive(self):
         """create tgz archive"""
-        # check if tar needs to be created first
-        self._page_archiver.gzip_archive()
+        self._archiver.gzip_archive()
 
     # send to remote systems
     def archive_remote(self):
@@ -84,8 +120,8 @@ class Archiver:
     def _archive_minio(self, obj_config: StorageProviderConfig):
         minio_archiver = MinioArchiver(obj_config.access_key,
                                        obj_config.secret_key, obj_config.config)
-        minio_archiver.upload_backup(self._page_archiver.archive_file)
-        minio_archiver.clean_up(self._page_archiver.file_extension_map['tgz'])
+        minio_archiver.upload_backup(self._archiver.archive_file)
+        minio_archiver.clean_up(self._archiver.file_extension_map['tgz'])
 
     def _archive_s3(self, obj_config: StorageProviderConfig):
         raise NotImplementedError("S3 remote storage is not yet implemented")
@@ -99,11 +135,11 @@ class Archiver:
         if to_delete:
             self._delete_files(to_delete)
 
-    def _get_stale_archives(self) -> List[str]:
+    def _get_stale_archives(self) -> list[str]:
         # if user is uploading to object storage
         # delete the local .tgz archive since we have it there already
-        archive_list: List[str] = util.scan_archives(self.base_dir,
-                                                     self._page_archiver.file_extension_map['tgz'])
+        archive_list: list[str] = util.scan_archives(self.base_dir,
+                                                     self._archiver.file_extension_map['tgz'])
         if not archive_list:
             log.debug("No archive files found to clean up")
             return []
@@ -120,7 +156,7 @@ class Archiver:
             to_delete = self._filter_archives(archive_list)
         return to_delete
 
-    def _filter_archives(self, file_list: List[str]) -> List[str]:
+    def _filter_archives(self, file_list: list[str]) -> list[str]:
         """get older archives based on keep number"""
         file_dict = {file: os.stat(file).st_ctime for file in file_list}
         ordered = sorted(file_dict.items(), key=lambda item: item[1])
@@ -134,10 +170,22 @@ class Archiver:
         log.debug("%d local archives will be cleaned up", len(files_to_clean))
         return files_to_clean
 
-    def _delete_files(self, file_list: List[str]):
+    def _delete_files(self, file_list: list[str]):
         for file in file_list:
             util.remove_file(file)
 
+    @staticmethod
+    def _level_base_dir(base_dir: str, export_level: str) -> str:
+        """Append the export level to the archive base name for non-default levels.
+
+        `pages` (the default) stays byte-identical to prior behavior; `books` and
+        `chapters` get a distinguishable name (e.g. `bkps_books`). Because keep_last
+        cleanup globs on this base, retention is naturally scoped per level.
+        """
+        if export_level == "pages":
+            return base_dir
+        return f"{base_dir}_{export_level}"
+
     @staticmethod
     def _generate_root_folder(base_folder_name: str) -> str:
         """return base archive name"""