codarascan 0.2.0__tar.gz → 0.2.1__tar.gz

{codarascan-0.2.0 → codarascan-0.2.1}/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes are recorded here. CodaraScan follows semantic versioning
 after 1.0; during 0.x, breaking changes are identified explicitly.
 
+## 0.2.1 - 2026-09-09
+
+- Make persistent worker request concurrency configurable with
+  `codarascan _worker --workers N` and `WorkerServer(..., workers=N)`.
+- Default the persistent request pool to one worker instead of deriving its
+  size from the host CPU count, and document its interaction with PDF page
+  workers.
+
 ## 0.2.0 - 2026-09-07
 
 - Add the Panorama high-recall extraction engine and public

{codarascan-0.2.0 → codarascan-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codarascan
-Version: 0.2.0
+Version: 0.2.1
 Summary: Open-source, offline barcode detection, localization, and decoding for images and PDFs
 Author-email: Abderraouf FELLAHI <ma_fellahi@esi.dz>
 License-Expression: Apache-2.0
@@ -73,7 +73,7 @@ For teams looking for a universal barcode detection layer, CodaraScan provides o
 [Formats](#supported-barcode-formats) · [API reference](https://github.com/flh-raouf/codarascan/blob/main/docs/API.md) ·
 [PyPI](https://pypi.org/project/codarascan/)
 
-> **Alpha notice — CodaraScan 0.2.0 is alpha software.** Its APIs and schemas
+> **Alpha notice — CodaraScan 0.2.1 is alpha software.** Its APIs and schemas
 > may change during 0.x. Pin an exact version and evaluate it against your own documents before
 > production use. See the [known limitations](https://github.com/flh-raouf/codarascan/blob/main/docs/KNOWN_LIMITATIONS.md)
 > and [release policy](https://github.com/flh-raouf/codarascan/blob/main/docs/RELEASE.md).
@@ -89,7 +89,7 @@ Most barcode libraries focus on decoding a clean, tightly cropped symbol. Docume
 | Barcode decoding | Returns Unicode text, exact raw payload bytes, and a canonical format name |
 | Document scanning | Reads selected PDF pages, preserves requested order, and supports bounded parallel work |
 | Batch processing | Scans complete or selected multi-page PDFs and can stream pages without accumulating them |
-| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.0 |
+| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.1 |
 | Recovery profiles | `fast` Tessera for lower latency; `robust` Mosaic for stronger recovery; `panorama` for maximum recall |
 | Local processing | No server, network request, telemetry, external executable, or runtime model download |
 | Integration | Typed Python API, deterministic JSON, CLI, schemas, and a private persistent worker protocol |
@@ -116,7 +116,7 @@ python -m pip install codarascan
 For reproducible alpha deployments, pin the current release:
 
 ```bash
-python -m pip install codarascan==0.2.0
+python -m pip install codarascan==0.2.1
 ```
 
 
@@ -285,7 +285,7 @@ Avoid choosing a mode from synthetic benchmarks alone.
 
 ## Supported barcode formats
 
-CodaraScan 0.2.0 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
+CodaraScan 0.2.1 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
 
 ### 1D and linear barcodes
 
@@ -384,9 +384,52 @@ Human-readable output is the default. `--json` emits one shared-schema result; `
 
 Run `codarascan image --help` or `codarascan document --help` for every option.
 
+### Understanding `workers`
+
+CodaraScan has two separate worker settings, depending on how it is used.
+
+For a one-off PDF scan, `--workers` controls how many pages from that PDF may
+be analyzed concurrently:
+
+```bash
+codarascan document archive.pdf --workers 12
+```
+
+CodaraScan starts, scans the PDF, returns the result, and exits. There is no
+need to start a persistent worker process first. Image scans use the `image`
+command without `--workers`, because a single image is processed as one input:
+
+```bash
+codarascan image barcode.png
+```
+
+Backend services and language adapters can instead keep CodaraScan running as
+a persistent process:
+
+```bash
+codarascan _worker --workers 12
+```
+
+Here, `--workers` controls how many separate incoming scan requests may execute
+concurrently. The process receives framed JSON requests through standard input.
+Each PDF request may also provide its own `workers` value, which controls how
+many pages inside that PDF are analyzed concurrently.
+
+Choose both values together. For example, 12 concurrent requests with 12 page
+workers per PDF can create up to 144 page-analysis tasks:
+
+```text
+12 concurrent requests × 12 page workers = up to 144 page tasks
+```
+
+That can increase CPU and memory usage and may reduce overall throughput. A
+service can use several request workers with one page worker per request, or
+fewer request workers with more page workers for large PDFs. Both settings
+default to `1`.
+
 ## Platform support
 
-Official 0.2.0 wheels target:
+Official 0.2.1 wheels target:
 
 | Operating system | Architectures | Python |
 |---|---|---|
@@ -430,7 +473,7 @@ Yes. Barcode detection, decoding, PDF rendering, the CLI, and the worker all run
 
 ### Is CodaraScan a universal barcode reader?
 
-It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.0. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
+It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.1. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
 
 
 ### Which mode should I use?

{codarascan-0.2.0 → codarascan-0.2.1}/README.md

@@ -16,7 +16,7 @@ For teams looking for a universal barcode detection layer, CodaraScan provides o
 [Formats](#supported-barcode-formats) · [API reference](https://github.com/flh-raouf/codarascan/blob/main/docs/API.md) ·
 [PyPI](https://pypi.org/project/codarascan/)
 
-> **Alpha notice — CodaraScan 0.2.0 is alpha software.** Its APIs and schemas
+> **Alpha notice — CodaraScan 0.2.1 is alpha software.** Its APIs and schemas
 > may change during 0.x. Pin an exact version and evaluate it against your own documents before
 > production use. See the [known limitations](https://github.com/flh-raouf/codarascan/blob/main/docs/KNOWN_LIMITATIONS.md)
 > and [release policy](https://github.com/flh-raouf/codarascan/blob/main/docs/RELEASE.md).
@@ -32,7 +32,7 @@ Most barcode libraries focus on decoding a clean, tightly cropped symbol. Docume
 | Barcode decoding | Returns Unicode text, exact raw payload bytes, and a canonical format name |
 | Document scanning | Reads selected PDF pages, preserves requested order, and supports bounded parallel work |
 | Batch processing | Scans complete or selected multi-page PDFs and can stream pages without accumulating them |
-| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.0 |
+| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.1 |
 | Recovery profiles | `fast` Tessera for lower latency; `robust` Mosaic for stronger recovery; `panorama` for maximum recall |
 | Local processing | No server, network request, telemetry, external executable, or runtime model download |
 | Integration | Typed Python API, deterministic JSON, CLI, schemas, and a private persistent worker protocol |
@@ -59,7 +59,7 @@ python -m pip install codarascan
 For reproducible alpha deployments, pin the current release:
 
 ```bash
-python -m pip install codarascan==0.2.0
+python -m pip install codarascan==0.2.1
 ```
 
 
@@ -228,7 +228,7 @@ Avoid choosing a mode from synthetic benchmarks alone.
 
 ## Supported barcode formats
 
-CodaraScan 0.2.0 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
+CodaraScan 0.2.1 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
 
 ### 1D and linear barcodes
 
@@ -327,9 +327,52 @@ Human-readable output is the default. `--json` emits one shared-schema result; `
 
 Run `codarascan image --help` or `codarascan document --help` for every option.
 
+### Understanding `workers`
+
+CodaraScan has two separate worker settings, depending on how it is used.
+
+For a one-off PDF scan, `--workers` controls how many pages from that PDF may
+be analyzed concurrently:
+
+```bash
+codarascan document archive.pdf --workers 12
+```
+
+CodaraScan starts, scans the PDF, returns the result, and exits. There is no
+need to start a persistent worker process first. Image scans use the `image`
+command without `--workers`, because a single image is processed as one input:
+
+```bash
+codarascan image barcode.png
+```
+
+Backend services and language adapters can instead keep CodaraScan running as
+a persistent process:
+
+```bash
+codarascan _worker --workers 12
+```
+
+Here, `--workers` controls how many separate incoming scan requests may execute
+concurrently. The process receives framed JSON requests through standard input.
+Each PDF request may also provide its own `workers` value, which controls how
+many pages inside that PDF are analyzed concurrently.
+
+Choose both values together. For example, 12 concurrent requests with 12 page
+workers per PDF can create up to 144 page-analysis tasks:
+
+```text
+12 concurrent requests × 12 page workers = up to 144 page tasks
+```
+
+That can increase CPU and memory usage and may reduce overall throughput. A
+service can use several request workers with one page worker per request, or
+fewer request workers with more page workers for large PDFs. Both settings
+default to `1`.
+
 ## Platform support
 
-Official 0.2.0 wheels target:
+Official 0.2.1 wheels target:
 
 | Operating system | Architectures | Python |
 |---|---|---|
@@ -373,7 +416,7 @@ Yes. Barcode detection, decoding, PDF rendering, the CLI, and the worker all run
 
 ### Is CodaraScan a universal barcode reader?
 
-It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.0. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
+It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.1. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
 
 
 ### Which mode should I use?

{codarascan-0.2.0 → codarascan-0.2.1}/docs/COMPATIBILITY.md

@@ -2,7 +2,7 @@
 
 ## Interpreter and platform matrix
 
-CodaraScan 0.2.0 declares CPython 3.11, 3.12, 3.13, and 3.14. The official
+CodaraScan 0.2.1 declares CPython 3.11, 3.12, 3.13, and 3.14. The official
 wheel target matrix is:
 
 | Platform | Architectures | Wheel expectation |

{codarascan-0.2.0 → codarascan-0.2.1}/docs/KNOWN_LIMITATIONS.md

@@ -1,4 +1,4 @@
-# Known limitations in 0.2.0 alpha
+# Known limitations in 0.2.1 alpha
 
 - Degraded-corpus validation is deepest for established QR Code, Data Matrix,
   and common linear workflows. Broader catalog blur, glare, perspective,

{codarascan-0.2.0 → codarascan-0.2.1}/docs/WORKER_PROTOCOL.md

@@ -4,6 +4,14 @@
 adapters. It reads standard input and writes standard output. It opens no
 socket, HTTP server, or external connection. Warnings use standard error.
 
+The request pool defaults to one worker. Set `codarascan _worker --workers 4`
+or `python -m codarascan.worker --workers 4` to process up to four requests
+concurrently. Python callers can use `WorkerServer(reader, writer, workers=4)`.
+The count must be a positive integer; it is never inferred from CPU count.
+This controls concurrent requests. The separate `workers` parameter for
+`scan_document` and `iter_document` controls page analysis within each request
+and still defaults to 1 (with explicit `"auto"` supported).
+
 Each message is four bytes containing an unsigned big-endian payload length,
 followed by exactly that many UTF-8 JSON bytes. JSON may contain newlines and
 may be larger than a line. The worker applies no additional public frame-size

{codarascan-0.2.0 → codarascan-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codarascan"
-version = "0.2.0"
+version = "0.2.1"
 description = "Open-source, offline barcode detection, localization, and decoding for images and PDFs"
 readme = "README.md"
 requires-python = ">=3.11,<3.15"

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/__init__.py

@@ -1,7 +1,7 @@
 # SPDX-License-Identifier: Apache-2.0
 """CodaraScan public API."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 from .core.contracts import Roi
 from .documents import DocumentInput, DocumentStream, ErrorPolicy, WorkerCount

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/cli.py

@@ -81,6 +81,16 @@ def _workers(value: str) -> int | str:
     return parsed
 
 
+def _request_workers(value: str) -> int:
+    try:
+        parsed = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("workers must be a positive integer") from exc
+    if parsed < 1:
+        raise argparse.ArgumentTypeError("workers must be a positive integer")
+    return parsed
+
+
 def _add_scanner_options(parser: argparse.ArgumentParser) -> None:
     parser.add_argument(
         "--mode", choices=("fast", "robust", "panorama"), default="fast"
@@ -119,7 +129,11 @@ def build_parser() -> argparse.ArgumentParser:
     document.add_argument("--workers", type=_workers, default=1)
     document.add_argument("--on-error", choices=("raise", "collect"), default="raise")
     _add_scanner_options(document)
-    subparsers.add_parser("_worker")
+    worker = subparsers.add_parser("_worker")
+    worker.add_argument(
+        "--workers", type=_request_workers, default=1,
+        help="number of concurrent requests (default: 1)",
+    )
     return parser
 
 
@@ -233,7 +247,7 @@ def run(arguments: argparse.Namespace) -> int:
     if arguments.command == "_worker":
         from .worker import main as worker_main
 
-        return worker_main()
+        return worker_main(workers=arguments.workers)
     scanner = _scanner(arguments)
     if arguments.command == "image":
         result: ImageResult | DocumentResult = scanner.scan_image(

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/schemas/result.decoded.example.json

@@ -4,9 +4,9 @@
   "height": 80,
   "elapsed_ms": 1.25,
   "metadata": {
-    "package_version": "0.2.0",
+    "package_version": "0.2.1",
     "engine": "tessera-extractor",
-    "engine_version": "0.2.0",
+    "engine_version": "0.2.1",
     "decoder_version": "3.1.1",
     "backend": "native",
     "mode": "fast"

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/schemas/result.localized.example.json

@@ -4,9 +4,9 @@
   "height": 80,
   "elapsed_ms": 1.5,
   "metadata": {
-    "package_version": "0.2.0",
+    "package_version": "0.2.1",
     "engine": "mosaic-extractor",
-    "engine_version": "0.2.0",
+    "engine_version": "0.2.1",
     "decoder_version": "3.1.1",
     "backend": "python",
     "mode": "robust"

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/schemas/result.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://codarascan.dev/schemas/result-0.2.0.json",
+  "$id": "https://codarascan.dev/schemas/result-0.2.1.json",
   "title": "CodaraScan result",
   "oneOf": [
     { "$ref": "#/$defs/image" },

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/schemas/stream.example.json

@@ -5,9 +5,9 @@
   "errors": [],
   "elapsed_ms": 4.5,
   "metadata": {
-    "package_version": "0.2.0",
+    "package_version": "0.2.1",
     "engine": "tessera-extractor",
-    "engine_version": "0.2.0",
+    "engine_version": "0.2.1",
     "decoder_version": "3.1.1",
     "backend": "native",
     "mode": "fast"

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/schemas/stream.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://codarascan.dev/schemas/stream-0.2.0.json",
+  "$id": "https://codarascan.dev/schemas/stream-0.2.1.json",
   "title": "CodaraScan NDJSON document summary",
   "type": "object",
   "additionalProperties": false,

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan/worker.py

@@ -6,7 +6,6 @@ from __future__ import annotations
 import base64
 import binascii
 import json
-import os
 import struct
 import sys
 import threading
@@ -15,7 +14,7 @@ from concurrent.futures import Future, ThreadPoolExecutor
 from typing import Any, BinaryIO, cast
 
 from . import __version__
-from .errors import CodaraScanError, ProtocolError
+from .errors import CodaraScanError, ConfigurationError, ProtocolError
 from .scanner import Scanner
 
 PROTOCOL_VERSION = 1
@@ -116,7 +115,9 @@ def _error_payload(error: BaseException) -> dict[str, Any]:
 
 
 class WorkerServer:
-    def __init__(self, reader: BinaryIO, writer: BinaryIO) -> None:
+    def __init__(self, reader: BinaryIO, writer: BinaryIO, *, workers: int = 1) -> None:
+        if isinstance(workers, bool) or not isinstance(workers, int) or workers < 1:
+            raise ConfigurationError("workers must be a positive integer")
         self.reader = reader
         self.writer = writer
         self._write_lock = threading.Lock()
@@ -125,7 +126,7 @@ class WorkerServer:
         self._active_lock = threading.RLock()
         self._active: dict[Any, threading.Event] = {}
         self._executor = ThreadPoolExecutor(
-            max_workers=max(1, os.cpu_count() or 1),
+            max_workers=workers,
             thread_name_prefix="codarascan-worker",
         )
 
@@ -390,12 +391,14 @@ class WorkerServer:
             future.add_done_callback(completed_callback)
 
 
-def main() -> int:
-    return WorkerServer(sys.stdin.buffer, sys.stdout.buffer).run()
+def main(*, workers: int = 1) -> int:
+    return WorkerServer(sys.stdin.buffer, sys.stdout.buffer, workers=workers).run()
 
 
 if __name__ == "__main__":
-    raise SystemExit(main())
+    from .cli import main as cli_main
+
+    raise SystemExit(cli_main(["_worker", *sys.argv[1:]]))
 
 
 __all__ = [

{codarascan-0.2.0 → codarascan-0.2.1}/src/codarascan.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codarascan
-Version: 0.2.0
+Version: 0.2.1
 Summary: Open-source, offline barcode detection, localization, and decoding for images and PDFs
 Author-email: Abderraouf FELLAHI <ma_fellahi@esi.dz>
 License-Expression: Apache-2.0
@@ -73,7 +73,7 @@ For teams looking for a universal barcode detection layer, CodaraScan provides o
 [Formats](#supported-barcode-formats) · [API reference](https://github.com/flh-raouf/codarascan/blob/main/docs/API.md) ·
 [PyPI](https://pypi.org/project/codarascan/)
 
-> **Alpha notice — CodaraScan 0.2.0 is alpha software.** Its APIs and schemas
+> **Alpha notice — CodaraScan 0.2.1 is alpha software.** Its APIs and schemas
 > may change during 0.x. Pin an exact version and evaluate it against your own documents before
 > production use. See the [known limitations](https://github.com/flh-raouf/codarascan/blob/main/docs/KNOWN_LIMITATIONS.md)
 > and [release policy](https://github.com/flh-raouf/codarascan/blob/main/docs/RELEASE.md).
@@ -89,7 +89,7 @@ Most barcode libraries focus on decoding a clean, tightly cropped symbol. Docume
 | Barcode decoding | Returns Unicode text, exact raw payload bytes, and a canonical format name |
 | Document scanning | Reads selected PDF pages, preserves requested order, and supports bounded parallel work |
 | Batch processing | Scans complete or selected multi-page PDFs and can stream pages without accumulating them |
-| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.0 |
+| Format coverage | 40 selectable formats: 27 linear and 13 matrix selections in version 0.2.1 |
 | Recovery profiles | `fast` Tessera for lower latency; `robust` Mosaic for stronger recovery; `panorama` for maximum recall |
 | Local processing | No server, network request, telemetry, external executable, or runtime model download |
 | Integration | Typed Python API, deterministic JSON, CLI, schemas, and a private persistent worker protocol |
@@ -116,7 +116,7 @@ python -m pip install codarascan
 For reproducible alpha deployments, pin the current release:
 
 ```bash
-python -m pip install codarascan==0.2.0
+python -m pip install codarascan==0.2.1
 ```
 
 
@@ -285,7 +285,7 @@ Avoid choosing a mode from synthetic benchmarks alone.
 
 ## Supported barcode formats
 
-CodaraScan 0.2.0 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
+CodaraScan 0.2.1 exposes **40 selectable barcode formats** generated from the installed ZXing-C++ readable catalog: **27 linear/1D selections** and **13 matrix/2D selections**.
 
 ### 1D and linear barcodes
 
@@ -384,9 +384,52 @@ Human-readable output is the default. `--json` emits one shared-schema result; `
 
 Run `codarascan image --help` or `codarascan document --help` for every option.
 
+### Understanding `workers`
+
+CodaraScan has two separate worker settings, depending on how it is used.
+
+For a one-off PDF scan, `--workers` controls how many pages from that PDF may
+be analyzed concurrently:
+
+```bash
+codarascan document archive.pdf --workers 12
+```
+
+CodaraScan starts, scans the PDF, returns the result, and exits. There is no
+need to start a persistent worker process first. Image scans use the `image`
+command without `--workers`, because a single image is processed as one input:
+
+```bash
+codarascan image barcode.png
+```
+
+Backend services and language adapters can instead keep CodaraScan running as
+a persistent process:
+
+```bash
+codarascan _worker --workers 12
+```
+
+Here, `--workers` controls how many separate incoming scan requests may execute
+concurrently. The process receives framed JSON requests through standard input.
+Each PDF request may also provide its own `workers` value, which controls how
+many pages inside that PDF are analyzed concurrently.
+
+Choose both values together. For example, 12 concurrent requests with 12 page
+workers per PDF can create up to 144 page-analysis tasks:
+
+```text
+12 concurrent requests × 12 page workers = up to 144 page tasks
+```
+
+That can increase CPU and memory usage and may reduce overall throughput. A
+service can use several request workers with one page worker per request, or
+fewer request workers with more page workers for large PDFs. Both settings
+default to `1`.
+
 ## Platform support
 
-Official 0.2.0 wheels target:
+Official 0.2.1 wheels target:
 
 | Operating system | Architectures | Python |
 |---|---|---|
@@ -430,7 +473,7 @@ Yes. Barcode detection, decoding, PDF rendering, the CLI, and the worker all run
 
 ### Is CodaraScan a universal barcode reader?
 
-It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.0. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
+It is a multi-format barcode detection layer with 40 selectable 1D and 2D formats in version 0.2.1. No honest scanner can guarantee every barcode under every capture condition, so CodaraScan publishes the exact catalog, evidence, and known limitations instead of making an unlimited compatibility claim.
 
 
 ### Which mode should I use?