rtflite 2.5.4__tar.gz → 2.6.0__tar.gz

{rtflite-2.5.4 → rtflite-2.6.0}/PKG-INFO

@@ -1,38 +1,37 @@
 Metadata-Version: 2.4
 Name: rtflite
-Version: 2.5.4
+Version: 2.6.0
 Summary: Lightweight RTF composer for Python
-Project-URL: Homepage, https://pharmaverse.github.io/rtflite/
-Project-URL: Documentation, https://pharmaverse.github.io/rtflite/
-Project-URL: Repository, https://github.com/pharmaverse/rtflite
-Project-URL: Issues, https://github.com/pharmaverse/rtflite/issues
-Project-URL: Changelog, https://github.com/pharmaverse/rtflite/blob/main/CHANGELOG.md
+Author: Yilong Zhang, Nan Xiao
 Author-email: Yilong Zhang <elong0527@gmail.com>, Nan Xiao <me@nanx.me>
-License-File: LICENSE
-License-File: LICENSES_THIRD_PARTY
+License-Expression: MIT
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Healthcare Industry
 Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Office/Business :: Office Suites
 Classifier: Programming Language :: Python :: 3
 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: Programming Language :: Python :: 3.14
-Classifier: Topic :: Office/Business :: Office Suites
-Classifier: Topic :: Text Processing
-Requires-Python: >=3.10
 Requires-Dist: narwhals>=1.0.0
 Requires-Dist: pillow>=8.0.0
 Requires-Dist: polars>=1.0.0
 Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-docx>=1.0.0 ; extra == 'docx'
+Requires-Dist: pypdf>=5.0.0 ; extra == 'pdf'
+Requires-Python: >=3.10
+Project-URL: Homepage, https://pharmaverse.github.io/rtflite/
+Project-URL: Documentation, https://pharmaverse.github.io/rtflite/
+Project-URL: Repository, https://github.com/pharmaverse/rtflite
+Project-URL: Issues, https://github.com/pharmaverse/rtflite/issues
+Project-URL: Changelog, https://github.com/pharmaverse/rtflite/blob/main/CHANGELOG.md
 Provides-Extra: docx
-Requires-Dist: python-docx>=1.0.0; extra == 'docx'
 Provides-Extra: pdf
-Requires-Dist: pypdf>=5.0.0; extra == 'pdf'
 Description-Content-Type: text/markdown
 
 # rtflite <img src="https://github.com/pharmaverse/rtflite/raw/main/docs/assets/logo.png" align="right" width="120" />

rtflite-2.6.0/pyproject.toml

@@ -0,0 +1,131 @@
+[project]
+name = "rtflite"
+version = "2.6.0"
+description = "Lightweight RTF composer for Python"
+dependencies = [
+    "narwhals>=1.0.0",
+    "pillow>=8.0.0",
+    "polars>=1.0.0",
+    "pydantic>=2.0.0",
+]
+readme = "README.md"
+license = "MIT"
+requires-python = ">= 3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Healthcare Industry",
+    "Intended Audience :: Information Technology",
+    "Topic :: Text Processing",
+    "Topic :: Office/Business :: Office Suites",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+[[project.authors]]
+name = "Yilong Zhang"
+email = "elong0527@gmail.com"
+
+[[project.authors]]
+name = "Nan Xiao"
+email = "me@nanx.me"
+
+[project.optional-dependencies]
+docx = ["python-docx>=1.0.0"]
+pdf = ["pypdf>=5.0.0"]
+
+[project.urls]
+Homepage = "https://pharmaverse.github.io/rtflite/"
+Documentation = "https://pharmaverse.github.io/rtflite/"
+Repository = "https://github.com/pharmaverse/rtflite"
+Issues = "https://github.com/pharmaverse/rtflite/issues"
+Changelog = "https://github.com/pharmaverse/rtflite/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["uv_build>=0.12.10,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+source-exclude = [
+    "/docs",
+    "/tests",
+    "/scripts",
+    "/example_output",
+    "/htmlcov",
+    "/.github",
+    "/site",
+    "/zensical.toml",
+    "/AGENTS.md",
+    "/CLAUDE.md",
+    "/CONTRIBUTING.md",
+    "/CODE_OF_CONDUCT.md",
+    "/coverage.xml",
+    "/uv.lock",
+    "**/.gitignore",
+    "/.claude",
+    "/.mypy_cache",
+    "/.pytest_cache",
+    "/.ruff_cache",
+    "/.coverage",
+]
+wheel-exclude = [
+    "/docs",
+    "/tests",
+    "/scripts",
+    "/example_output",
+    "/htmlcov",
+    "/.github",
+    "/site",
+    "/zensical.toml",
+    "/AGENTS.md",
+    "/CLAUDE.md",
+    "/CONTRIBUTING.md",
+    "/CODE_OF_CONDUCT.md",
+    "/coverage.xml",
+    "/uv.lock",
+    "**/.gitignore",
+    "/.claude",
+    "/.mypy_cache",
+    "/.pytest_cache",
+    "/.ruff_cache",
+    "/.coverage",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "UP",
+    "B",
+    "SIM",
+    "I",
+]
+
+[[tool.mypy.overrides]]
+module = [
+    "docx",
+    "docx.*",
+    "pypdf",
+    "pypdf.*",
+]
+ignore_missing_imports = true
+
+[dependency-groups]
+dev = [
+    "griffe-pydantic>=1.1.8",
+    "isort>=5.13.2",
+    "markdown-exec[ansi]>=1.11.0",
+    "matplotlib>=3.10.5",
+    "mkdocstrings-python>=1.12.2",
+    "mypy>=1.17.1",
+    "pytest>=8.3.3",
+    "pytest-cov>=6.0.0",
+    "pytest-r-snapshot>=0.1.0",
+    "ruff>=0.7.4",
+    "zensical>=0.0.15",
+]

rtflite-2.5.4/pyproject.toml → rtflite-2.6.0/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "rtflite"
-version = "2.5.4"
+version = "2.6.0"
 description = "Lightweight RTF composer for Python"
 authors = [
     { name = "Yilong Zhang", email = "elong0527@gmail.com" },
@@ -13,6 +13,7 @@ dependencies = [
     "pydantic>=2.0.0",
 ]
 readme = "README.md"
+license = "MIT"
 requires-python = ">= 3.10"
 classifiers = [
     "Development Status :: 3 - Alpha",
@@ -25,8 +26,6 @@ classifiers = [
     "Topic :: Text Processing",
     "Topic :: Office/Business :: Office Suites",
 
-    "License :: OSI Approved :: MIT License",
-
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
@@ -47,11 +46,11 @@ Issues = "https://github.com/pharmaverse/rtflite/issues"
 Changelog = "https://github.com/pharmaverse/rtflite/blob/main/CHANGELOG.md"
 
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+requires = ["uv_build>=0.12.10,<0.13.0"]
+build-backend = "uv_build"
 
-[tool.hatch.build.targets.sdist]
-exclude = [
+[tool.uv.build-backend]
+source-exclude = [
     "/docs",
     "/tests",
     "/scripts",
@@ -73,9 +72,7 @@ exclude = [
     "/.ruff_cache",
     "/.coverage",
 ]
-
-[tool.hatch.build.targets.wheel]
-exclude = [
+wheel-exclude = [
     "/docs",
     "/tests",
     "/scripts",

{rtflite-2.5.4 → rtflite-2.6.0}/src/rtflite/convert.py

@@ -3,11 +3,11 @@ import platform
 import re
 import shutil
 import subprocess
+import tempfile
 from collections.abc import Sequence
+from math import isfinite
 from pathlib import Path
 
-from packaging import version
-
 from .dictionary.libreoffice import DEFAULT_PATHS, MIN_VERSION
 
 
@@ -27,17 +27,28 @@ class LibreOfficeConverter:
         This makes it suitable for server environments and automated workflows.
     """
 
-    def __init__(self, executable_path: str | Path | None = None):
+    def __init__(
+        self,
+        executable_path: str | Path | None = None,
+        *,
+        timeout: float | None = 120,
+    ) -> None:
         """Initialize converter with optional executable path.
 
         Args:
             executable_path: Path (or executable name) to LibreOffice. If None,
                 searches standard installation locations for each platform.
+            timeout: Maximum seconds for each LibreOffice process, including
+                the version check. Defaults to 120. Use None to disable.
 
         Raises:
             FileNotFoundError: If LibreOffice executable cannot be found.
-            ValueError: If LibreOffice version is below minimum requirement.
+            ValueError: If timeout is invalid or the version cannot be parsed.
+            RuntimeError: If LibreOffice is too old, fails to start, or times out.
         """
+        if timeout is not None and (not isfinite(timeout) or timeout <= 0):
+            raise ValueError("timeout must be a positive finite number or None.")
+        self.timeout = timeout
         self.executable_path = self._resolve_executable_path(executable_path)
 
         self._verify_version()
@@ -53,15 +64,15 @@ class LibreOfficeConverter:
         executable = os.fspath(executable_path)
         expanded = os.path.expanduser(executable)
         candidate = Path(expanded)
-        candidate_str = str(candidate)
         looks_like_path = (
-            candidate.is_absolute()
-            or os.sep in candidate_str
-            or (os.altsep is not None and os.altsep in candidate_str)
+            isinstance(executable_path, Path)
+            or candidate.is_absolute()
+            or os.sep in expanded
+            or (os.altsep is not None and os.altsep in expanded)
         )
         if looks_like_path:
             if candidate.is_file():
-                return candidate
+                return candidate.absolute()
             raise FileNotFoundError(
                 f"LibreOffice executable not found at: {candidate}."
             )
@@ -69,16 +80,20 @@ class LibreOfficeConverter:
         resolved_executable = shutil.which(executable)
         if resolved_executable is None:
             raise FileNotFoundError(f"Can't find LibreOffice executable: {executable}.")
-        return Path(resolved_executable)
+        return Path(resolved_executable).absolute()
 
     def _find_executable(self) -> Path | None:
         """Find LibreOffice executable in default locations."""
-        for name in ("soffice", "libreoffice"):
+        system = platform.system()
+        # Windows needs the console launcher to capture output and wait for exit.
+        names: tuple[str, ...] = ("soffice", "libreoffice")
+        if system == "Windows":
+            names = ("soffice.com", *names)
+        for name in names:
             resolved = shutil.which(name)
             if resolved is not None:
-                return Path(resolved)
+                return Path(resolved).absolute()
 
-        system = platform.system()
         if system not in DEFAULT_PATHS:
             raise RuntimeError(f"Unsupported operating system: {system}.")
 
@@ -88,34 +103,53 @@ class LibreOfficeConverter:
                 return candidate
         return None
 
-    def _verify_version(self):
-        """Verify LibreOffice version meets minimum requirement."""
+    def _run_command(
+        self, cmd: list[str], action: str
+    ) -> subprocess.CompletedProcess[str]:
+        """Run LibreOffice with bounded execution and useful diagnostics."""
         try:
-            result = subprocess.run(
-                [str(self.executable_path), "--version"],
+            return subprocess.run(
+                cmd,
                 capture_output=True,
                 text=True,
+                errors="replace",
                 check=True,
+                timeout=self.timeout,
             )
-            version_str = result.stdout.strip()
-            # Extract version number (for example, "24.8.3.2" from the output)
-            match = re.search(r"LibreOffice (\d+\.\d+)", version_str)
-            if not match:
-                raise ValueError(
-                    f"Can't parse LibreOffice version from: {version_str}."
-                )
-
-            current_version = version.parse(match.group(1))
-            min_version = version.parse(MIN_VERSION)
-
-            if current_version < min_version:
-                raise RuntimeError(
-                    "LibreOffice version "
-                    f"{current_version} is below minimum required "
-                    f"version {min_version}."
-                )
+        except subprocess.TimeoutExpired as e:
+            raise RuntimeError(
+                f"LibreOffice {action} timed out after {self.timeout} seconds."
+            ) from e
         except subprocess.CalledProcessError as e:
-            raise RuntimeError(f"Failed to get LibreOffice version: {e}.") from e
+            raise RuntimeError(
+                f"LibreOffice {action} failed (exit code {e.returncode}):\n"
+                f"Command output: {e.stdout}\n"
+                f"Error output: {e.stderr}"
+            ) from e
+        except OSError as e:
+            raise RuntimeError(
+                f"Failed to run LibreOffice at {self.executable_path}: {e}"
+            ) from e
+
+    def _verify_version(self) -> None:
+        """Verify LibreOffice version meets minimum requirement."""
+        result = self._run_command(
+            [str(self.executable_path), "--version"], "version check"
+        )
+        version_str = result.stdout.strip()
+        match = re.search(r"LibreOffice\s+(\d+\.\d+(?:\.\d+)*)", version_str)
+        if not match:
+            raise ValueError(f"Can't parse LibreOffice version from: {version_str}.")
+
+        # LibreOffice uses numeric versions, including calendar versions (24+).
+        # Compare numerically without requiring the optional packaging library.
+        current_version = tuple(int(part) for part in match.group(1).split("."))
+        min_version = tuple(int(part) for part in MIN_VERSION.split("."))
+        if current_version < min_version:
+            raise RuntimeError(
+                f"LibreOffice version {match.group(1)} is below minimum required "
+                f"version {MIN_VERSION}."
+            )
 
     def convert(
         self,
@@ -142,16 +176,30 @@ class LibreOfficeConverter:
                 - `'html'`: HTML Document
                 - `'odt'`: OpenDocument Text
                 - `'txt'`: Plain Text
+
+                Also accepts LibreOffice's `extension:filter[:options]` syntax,
+                for example `'pdf:writer_pdf_Export'` or
+                `'txt:Text (encoded):UTF8'`. Filter names and options are passed
+                through unchanged; the extension determines the output filename.
             overwrite: If `True`, overwrites existing files in output directory.
-                If `False`, raises error if output file already exists.
+                If `False`, raises error if output file already exists. Existing
+                output is preserved if LibreOffice fails to convert the input.
 
         Returns:
             Path | Sequence[Path]: For single file input, returns Path to the
                 converted file. For multiple files, returns list of Paths.
 
         Raises:
+            FileNotFoundError: If an input file is missing or is not a file.
             FileExistsError: If output file exists and overwrite=False.
-            RuntimeError: If LibreOffice conversion fails.
+            ValueError: If format does not start with a valid file extension.
+            RuntimeError: If LibreOffice conversion fails or times out.
+
+        Note:
+            Each file is converted with a temporary, isolated LibreOffice user
+            profile, independent of an open desktop session or other conversions.
+            Personal LibreOffice settings and extensions are not used. Batch
+            inputs are processed sequentially, with a new process for each file.
 
         Examples:
             Single file conversion:
@@ -178,21 +226,26 @@ class LibreOfficeConverter:
                 print(f"Converted: {path}")
             ```
         """
-        output_dir = Path(os.path.expanduser(str(output_dir)))
-        if not output_dir.exists():
-            output_dir.mkdir(parents=True)
+        extension = format.split(":", 1)[0]
+        if not re.fullmatch(r"[A-Za-z0-9]+", extension):
+            raise ValueError(
+                "format must be an extension or extension:filter[:options], "
+                f"got {format!r}."
+            )
+        output_dir = Path(output_dir).expanduser()
+        output_dir.mkdir(parents=True, exist_ok=True)
 
         # Handle single input file
         if isinstance(input_files, (str, Path)):
-            input_path = Path(os.path.expanduser(str(input_files)))
-            if not input_path.exists():
+            input_path = Path(input_files).expanduser()
+            if not input_path.is_file():
                 raise FileNotFoundError(f"Input file not found: {input_path}.")
             return self._convert_single_file(input_path, output_dir, format, overwrite)
 
         # Handle multiple input files
-        input_paths = [Path(os.path.expanduser(str(f))) for f in input_files]
+        input_paths = [Path(f).expanduser() for f in input_files]
         for path in input_paths:
-            if not path.exists():
+            if not path.is_file():
                 raise FileNotFoundError(f"Input file not found: {path}.")
 
         return [
@@ -204,7 +257,8 @@ class LibreOfficeConverter:
         self, input_file: Path, output_dir: Path, format: str, overwrite: bool
     ) -> Path:
         """Convert a single file using LibreOffice."""
-        output_file = output_dir / f"{input_file.stem}.{format}"
+        extension = format.split(":", 1)[0]
+        output_file = output_dir / f"{input_file.stem}.{extension}"
 
         if output_file.exists() and not overwrite:
             raise FileExistsError(
@@ -212,33 +266,51 @@ class LibreOfficeConverter:
                 "Use overwrite=True to force."
             )
 
-        cmd = [
-            str(self.executable_path),
-            "--invisible",
-            "--headless",
-            "--nologo",
-            "--convert-to",
-            format,
-            "--outdir",
-            str(output_dir),
-            str(input_file),
-        ]
-
-        try:
-            result = subprocess.run(cmd, capture_output=True, text=True, check=True)
-
-            if not output_file.exists():
+        # Stage output so an old file cannot be mistaken for a successful export.
+        # Keep it on the destination filesystem for the final file replacement.
+        with tempfile.TemporaryDirectory(prefix=".rtflite-", dir=output_dir) as tmpdir:
+            work_dir = Path(tmpdir).resolve()
+            converted_dir = work_dir / "output"
+            converted_dir.mkdir()
+            cmd = [
+                str(self.executable_path),
+                f"-env:UserInstallation={(work_dir / 'profile').as_uri()}",
+                "--headless",
+                "--nologo",
+                "--norestore",
+                "--convert-to",
+                format,
+                "--outdir",
+                str(converted_dir),
+                str(input_file.absolute()),
+            ]
+            result = self._run_command(cmd, "conversion")
+            converted_file = converted_dir / output_file.name
+            if not converted_file.is_file():
                 raise RuntimeError(
                     f"Conversion failed: Output file not created.\n"
                     f"Command output: {result.stdout}\n"
                     f"Error output: {result.stderr}"
                 )
 
-            return output_file
-
-        except subprocess.CalledProcessError as e:
-            raise RuntimeError(
-                f"LibreOffice conversion failed:\n"
-                f"Command output: {e.stdout}\n"
-                f"Error output: {e.stderr}"
-            ) from e
+            # Include companion files/directories created by formats such as HTML.
+            generated_paths = list(converted_dir.iterdir())
+            if not overwrite:
+                for path in generated_paths:
+                    destination = output_dir / path.name
+                    if destination.exists():
+                        raise FileExistsError(
+                            f"Output file already exists: {destination}. "
+                            "Use overwrite=True to force."
+                        )
+            for path in generated_paths:
+                if path == converted_file:
+                    continue
+                destination = output_dir / path.name
+                if path.is_dir():
+                    shutil.copytree(path, destination, dirs_exist_ok=overwrite)
+                else:
+                    path.replace(destination)
+            converted_file.replace(output_file)
+
+        return output_file

{rtflite-2.5.4 → rtflite-2.6.0}/src/rtflite/encode.py

@@ -574,9 +574,9 @@ class RTFDocument(BaseModel):
             ```
 
         Note:
-            LibreOffice may create a companion directory (for example
-            `report.html_files`) for embedded resources. When present, it is moved
-            alongside the requested output path.
+            LibreOffice may create companion image files or directories for
+            embedded resources. These are saved alongside the requested output
+            path and must be kept with the HTML file.
         """
         target_path = Path(file_path).expanduser()
         target_path.parent.mkdir(parents=True, exist_ok=True)
@@ -602,12 +602,13 @@ class RTFDocument(BaseModel):
                         f"{type(converted)!r} with value {converted!r}."
                     )
                 html_path = converted
-                resources_dir = html_path.with_name(f"{html_path.name}_files")
                 shutil.move(str(html_path), target_path)
-                if resources_dir.is_dir():
-                    shutil.move(
-                        str(resources_dir), target_path.parent / resources_dir.name
-                    )
+                for resource in Path(convert_tmpdir).iterdir():
+                    destination = target_path.parent / resource.name
+                    if resource.is_dir():
+                        shutil.copytree(resource, destination, dirs_exist_ok=True)
+                    else:
+                        shutil.move(str(resource), destination)
 
         print(target_path)
 

rtflite-2.5.4/.gitignore

@@ -1,28 +0,0 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-site/
-wheels/
-*.egg-info
-*.xml
-
-# Virtual environments
-.venv
-
-# OS
-.DS_Store
-
-# pytest
-.coverage
-
-# r2rtf
-Rplots.pdf
-
-# markdown-exec artifacts
-/docs/articles/pdf/
-/docs/articles/images/
-
-# Generated docx artifacts (not bitwise deterministic)
-/docs/articles/rtf/*.docx

rtflite-2.5.4/.python-version

@@ -1 +0,0 @@
-3.14.3

rtflite-2.5.4/CHANGELOG.md

@@ -1,359 +0,0 @@
-# Changelog
-
-## rtflite 2.5.4
-
-### Bug fixes
-
-- Normalize `rtf_body` sequences at the document boundary and fix mypy
-  type narrowing for multi-section `rtf_body` handling (#202).
-  `RTFDocument.rtf_body` is now typed as `RTFBody | list[RTFBody] | None`,
-  with a field validator that converts non-list `Sequence[RTFBody]` inputs
-  to `list[RTFBody]`. Single-section documents now reject multi-body
-  containers with a clear error instead of failing with attribute access
-  errors downstream.
-
-### Dependencies
-
-- Remove pandas and pyarrow from development dependencies (#194).
-
-### Maintenance
-
-- Add a script to automate sorting dependencies in `pyproject.toml` and
-  re-sort pyproject dependencies using the script (#193).
-
-## rtflite 2.5.3
-
-### Documentation
-
-- Update mkdocstrings settings to render Pydantic field metadata
-  via `griffe-pydantic` in API reference docs (#189).
-- Declare `RTFDocument._table_space` as a Pydantic private attribute to
-  prevent mkdocstrings render errors in static mode (#189).
-- Add Code Wiki link as README badge and site navigation link.
-  This is a useful resource that helps developers and AI agents
-  understand the codebase fast (#191).
-
-## rtflite 2.5.2
-
-### Documentation
-
-- Migrated documentation site to use Zensical (#184, #185).
-
-## rtflite 2.5.1
-
-### Testing
-
-- Migrated the RTF snapshot tests implementation to a proper solution
-  `pytest-r-snapshot` to reduce boilerplate code and improve maintainability.
-  The legacy fixture generation workflow is removed and the snapshots are
-  stored under the standard location `tests/__r_snapshots__/` (#181).
-
-## rtflite 2.5.0
-
-### New features
-
-- Added `RTFDocument.write_html` and `RTFDocument.write_pdf` for exporting RTF
-  documents to HTML and PDF via LibreOffice, matching the `write_docx`
-  conversion workflow (#176).
-
-### Testing
-
-- Added parameterized tests covering DOCX, HTML, and PDF exports, with a
-  new `pdf` extra (`pypdf`) for PDF text extraction.
-  Improved LibreOffice availability checks to skip integration tests
-  when conversion is not working (#176).
-
-## rtflite 2.4.0
-
-### Breaking changes
-
-- Removed the `executable_path` argument from `RTFDocument.write_docx`; pass
-  `converter=LibreOfficeConverter(executable_path=...)` instead (#172).
-
-### Improvements
-
-- `RTFDocument.write_docx` now accepts a `converter=` instance to configure
-  LibreOffice invocation (including custom executable paths) and to enable
-  reusing a converter across multiple conversions (#172).
-
-### Converters
-
-- `LibreOfficeConverter(executable_path=...)` now accepts `Path` objects
-  and resolves executable names via `PATH` when given
-  (for example, `"soffice"`) (#172).
-
-## rtflite 2.3.1
-
-### Improvements
-
-- Added `executable_path` parameter to `write_docx()` method (#170).
-- Added `/tmp/soffice` and `/tmp/libreoffice` paths for Linux (#170).
-
-## rtflite 2.3.0
-
-### New features
-
-- Added `concatenate_docx` function to merge DOCX outputs without manual
-  field refreshes, preserving per-section orientation (#160).
-
-### Testing
-
-- Added DOCX concatenation coverage and centralized optional dependency
-  skip markers for `python-docx` and LibreOffice to keep tests gated
-  appropriately (#160).
-
-### Documentation
-
-- Updated the assembly article to use `concatenate_docx` in code examples and
-  added a reference page for assemble function to the documentation site (#160).
-
-## rtflite 2.2.0
-
-### New features
-
-- Added `RTFDocument.write_docx` to export tables as DOCX via LibreOffice,
-  with `str`/`Path` input support and automatic parent directory creation (#156).
-- Improved `write_rtf` to accept `Path` inputs and create missing output
-  directories (#156).
-
-### Documentation
-
-- Expanded DOCX assembly guidance with toggle field caveats and `python-docx`
-  concatenation examples (#157).
-- Documented installing the `docx` extra in the README and assemble article,
-  including `uv sync --extra docx` for developers (#155).
-
-## rtflite 2.1.1
-
-### Bug fixes
-
-- Reduced packaging files size by excluding unnecessary files and directories (#152).
-- Fixed an issue when paginating tables with `page_by` and `subline_by` (#152).
-
-## rtflite 2.1.0
-
-### New features
-
-- Added `assemble_rtf` and `assemble_docx` functions for RTF and DOCX assembly (#142).
-
-### Bug fixes
-
-- Fixed an issue where `RTFPage` orientation was not correctly respected during assembly in certain edge cases (#141).
-
-## rtflite 2.0.0
-
-### Breaking changes
-
-- Removed legacy pagination/encoding APIs, including `ContentDistributor`,
-  `PageDict`/`AdvancedPaginationService`, and the `SinglePageStrategy`/
-  `PaginatedStrategy` classes; dropped backwards-compatibility helpers
-  such as `text_convert` and `get_color_index` (#138).
-
-### Refactors
-
-- Introduced a unified rendering pipeline (`UnifiedRTFEncoder`) with a strategy
-  registry, page feature processor, and renderer that handle pagination,
-  borders, and page headers consistently, including combined `page_by` and
-  `subline_by` grouping (#138).
-- Simplified public exports by re-exporting `RTFEncodingEngine`,
-  `TableAttributes`, `RTFSubline`, and `get_string_width` from the top-level
-  package while reorganizing core config/constants imports (#138).
-
-### Testing and documentation
-
-- Added regression tests for combined grouping and `page_by` column alignment,
-  and removed obsolete advanced pagination tests; cleaned up RTF doc fixtures
-  and trimmed pagination reference docs to match the new architecture (#138).
-
-## rtflite 1.2.0
-
-### Bug fixes
-
-- Fixed `page_by` pagination when using `RTFPage(orientation="landscape")`,
-  covering single- and multi-page tables and aligning documentation examples
-  (#128, #131, #134).
-
-### Maintenance
-
-- Added GitHub Actions workflow to run `ruff check` for code linting,
-  updated GitHub Actions workflows to use `actions/checkout@v6`,
-  and updated badges in `README.md` (#133).
-
-## rtflite 1.1.1
-
-### New features
-
-- Enhanced group-by divider filtering functionality to support the
-  `-----` syntax (#118).
-
-### Bug fixes
-
-- Fixed text conversion issue for greater than or equal (>=) and less than or
-  equal (<=) symbols (#119).
-
-## rtflite 1.1.0
-
-### Python version support
-
-- Added Python 3.14 support by conditionally requiring pyarrow >= 22.0.0
-  under Python 3.14 (#114).
-
-### Linting and typing
-
-- Added ruff linter configuration to `pyproject.toml` with popular rule sets
-  and fixed all linting issues (#115).
-- Refactored type annotations to use built-in generics and abstract base classes
-  following modern typing best practices (#107).
-
-### Documentation
-
-- Added pharmaverse badge to the README (#108).
-- Added `AGENTS.md` with guidelines for AI coding agents (#109).
-
-### Maintenance
-
-- Updated GitHub Actions workflows to use the latest `checkout` and
-  `setup-python` versions (#114).
-- Refactored the logo generation script to use ImageMagick, removing the
-  R and hexSticker dependency (#111).
-
-## rtflite 1.0.2
-
-### Typing
-
-- Adopted modern typing best practices: use `|` unions instead of
-  `Union`/`Optional`, and built-in generics instead of `typing` aliases (#95).
-- Resolved all mypy issues; type checks now pass cleanly (#97, #99, #101).
-- Added a mypy GitHub Actions workflow for continuous type checking (#100).
-
-### Testing
-
-- Added a developer script to compare current RTF outputs with snapshots
-  generated from documentation site articles (#102).
-
-### Documentation
-
-- Updated `CLAUDE.md` to replace outdated `.qmd`-based rendering instructions
-  with the markdown-exec approach (#93).
-
-## rtflite 1.0.1
-
-### Bug fixes
-
-- Fixed hard-coded font in pagination calculations to properly use
-  user-selected fonts (#91).
-
-### Dependencies
-
-- Lowered minimum Pillow version to 8.0.0 with automatic font size type
-  coercion to `int` for Pillow < 10.0.0 compatibility (#89).
-
-### Documentation
-
-- Improved readability and technical accuracy of documentation (#85, #86, #87).
-
-## rtflite 1.0.0
-
-This major release marks rtflite as production-ready for table, listing,
-and figure generation in RTF format.
-It introduces advanced pagination features, enhanced group handling,
-complete color support, and significant architectural improvements
-for better maintainability and performance.
-
-### New features
-
-- **Advanced pagination features**
-    - Added the `subline_by` parameter for creating paragraph headers before each page group.
-    - Enhanced `group_by` functionality with hierarchical value suppression within groups.
-    - Implemented page context restoration for multi-page tables with `group_by`.
-
-- **Enhanced color system**
-    - Complete 657-color support with full r2rtf R package compatibility.
-
-- **Text conversion improvements**
-    - Text conversion (LaTeX to Unicode) enabled by default for all components.
-    - Better handling of special characters and symbols.
-    - Enhanced validation for text conversion operations.
-
-- **Table formatting**
-    - Added the `as_table` parameter for `RTFFootnote` and `RTFSource` components.
-    - Auto-inheritance of `col_rel_width` from `rtf_body` to `rtf_column_header`.
-    - Improved handling of table borders and footnote placement.
-
-### Architecture improvements
-
-- **Service-oriented architecture**
-    - Introduced dedicated service layer for complex operations.
-    - Implemented strategy pattern for encoding (`SinglePageStrategy`, `PaginatedStrategy`).
-    - Created `RTFEncodingEngine` for strategy orchestration.
-
-- **Code organization**
-    - Consolidated constants and eliminated magic numbers throughout the codebase.
-    - Method decomposition and improved input validation.
-    - Cleaner public interfaces with thorough error handling.
-
-### Dependency changes
-
-- Removed numpy and pandas as hard dependencies.
-- Moved pyarrow to development dependencies.
-- Now uses narwhals for DataFrame abstraction.
-- Prefer polars as the primary DataFrame interface.
-
-### Documentation
-
-- Added vignette-style articles to document the new features.
-- Reorganized API reference for better user experience.
-- Renamed documentation files to use hyphens consistently.
-- Updated all examples to use modern best practices.
-- Fixed Polars `DataOrientationWarning` in documentation examples.
-
-### Testing
-
-- Added single-page RTF tests with fixtures generated by r2rtf.
-- Added extensive multi-page tests for the `as_table` feature.
-
-## rtflite 0.1.3
-
-### Documentation
-
-- Add contributing guidelines to make it easy for onboarding new developers
-  to the recommended development workflow (#25).
-- Update `README.md` to add hyperlink to the R package r2rtf (#24).
-
-### Maintenance
-
-- Remove the strict version requirement for the development dependency
-  mkdocs-autorefs (#21).
-
-## rtflite 0.1.2
-
-### Maintenance
-
-- Manage project with uv (#19).
-- Update the logo image generation workflow to use web fonts (#18).
-
-## rtflite 0.1.1
-
-### Documentation
-
-- Use absolute URL to replace relative path for logo image in `README.md`,
-  for proper rendering on PyPI (#16).
-
-## rtflite 0.1.0
-
-### New features
-
-- Introduced core RTF document components, such as `RTFDocument`, `RTFPage`,
-  `RTFTitle`, `RTFColumnHeader`, and `RTFBody`. These classes establish the
-  foundation for composing structured RTF documents with a text encoding
-  pipeline. Use Pydantic for data validation.
-- Implemented string width calculation using Pillow with metric-compatible fonts.
-  This will be incorporated in the pagination and layout algorithms in
-  future releases.
-- Implemented a LibreOffice-based document converter for RTF to PDF conversion
-  with automatic LibreOffice detection mechanisms under Linux, macOS, and Windows.
-
-### Documentation
-
-- Added an article on creating baseline characteristics tables.
-- Integrated code coverage reports via pytest-cov into the documentation site.

rtflite-2.5.4/LICENSE

@@ -1,20 +0,0 @@
-Copyright (c) 2025 pharmaverse
-
-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.

rtflite-2.5.4/LICENSES_THIRD_PARTY

@@ -1,20 +0,0 @@
-rtflite uses third-party Python packages which may be distributed under
-different licenses. We have listed all of these third party packages and
-their licenses below. However, the most up-to-date information can be found
-via inspecting the dependencies field in the pyproject.toml file.
-
-You must agree to the terms of these licenses, in addition to the rtflite
-source code license, in order to use this software.
-
---------------------------------------------------
-Third party Python packages listed by license type
-[Format: Name - URL]
---------------------------------------------------
-
-MIT License (https://opensource.org/license/mit)
-  * narwhals - https://github.com/narwhals-dev/narwhals/blob/main/LICENSE.md
-  * polars - https://github.com/pola-rs/polars/blob/main/LICENSE
-  * pydantic - https://github.com/pydantic/pydantic/blob/main/LICENSE
-
-MIT-CMU License (https://opensource.org/license/cmu-license)
-  * pillow - https://github.com/python-pillow/Pillow/blob/main/LICENSE