rxiv-maker 1.16.6__py3-none-any.whl → 1.16.8__py3-none-any.whl

rxiv_maker/__version__.py

@@ -1,3 +1,3 @@
 """Version information."""
 
-__version__ = "1.16.6"
+__version__ = "1.16.8"

rxiv_maker/cli/commands/docx.py

@@ -1,15 +1,86 @@
 """DOCX export command for rxiv-maker CLI."""
 
+import platform
+import shutil
+import subprocess
+
 import rich_click as click
 from rich.console import Console
 
 from ...core.logging_config import get_logger
+from ...core.managers.dependency_manager import DependencyStatus, get_dependency_manager
 from ...exporters.docx_exporter import DocxExporter
 
 logger = get_logger()
 console = Console()
 
 
+def _check_and_offer_poppler_installation(console: Console, quiet: bool, verbose: bool) -> None:
+    """Check poppler availability and offer automatic installation via brew.
+
+    Args:
+        console: Rich console for output
+        quiet: Whether to suppress output
+        verbose: Whether verbose mode is enabled
+    """
+    # Check if poppler is installed
+    manager = get_dependency_manager()
+    result = manager.check_dependency("pdftoppm")
+
+    if result.status == DependencyStatus.AVAILABLE:
+        if verbose:
+            console.print("[dim]✓ Poppler utilities available[/dim]")
+        return
+
+    # Poppler is missing - offer to install
+    system = platform.system()
+
+    if system == "Darwin" and shutil.which("brew"):
+        # macOS with Homebrew
+        if not quiet:
+            console.print("[yellow]⚠️  Poppler not found[/yellow]")
+            console.print("   Poppler is needed to embed PDF figures in DOCX files.")
+            console.print("   Without it, PDF figures will appear as placeholders.")
+            console.print()
+
+        if click.confirm("   Would you like to install poppler now via Homebrew?", default=True):
+            console.print("[cyan]Installing poppler...[/cyan]")
+            try:
+                result = subprocess.run(
+                    ["brew", "install", "poppler"],
+                    capture_output=True,
+                    text=True,
+                    timeout=300,
+                )
+
+                if result.returncode == 0:
+                    console.print("[green]✅ Poppler installed successfully![/green]")
+                    # Clear dependency cache so it gets re-checked
+                    manager.clear_cache()
+                else:
+                    console.print(f"[red]❌ Installation failed:[/red] {result.stderr}")
+                    console.print("   You can install manually with: brew install poppler")
+            except subprocess.TimeoutExpired:
+                console.print("[red]❌ Installation timed out[/red]")
+            except Exception as e:
+                console.print(f"[red]❌ Installation error:[/red] {e}")
+        else:
+            console.print("   [dim]Skipping poppler installation. PDF figures will show as placeholders.[/dim]")
+
+    elif system == "Linux":
+        # Linux
+        if not quiet:
+            console.print("[yellow]⚠️  Poppler not found[/yellow]")
+            console.print("   Install with: sudo apt install poppler-utils")
+            console.print()
+    else:
+        # Other platforms or brew not available
+        if not quiet:
+            console.print("[yellow]⚠️  Poppler not found[/yellow]")
+            console.print(f"   Install instructions: {result.resolution_hint}")
+            console.print()
+
+
 @click.command(context_settings={"help_option_names": ["-h", "--help"]})
 @click.argument(
     "manuscript_path",
@@ -86,6 +157,9 @@ def docx(
             include_footnotes=not no_footnotes,
         )
 
+        # Pre-flight check for poppler (if manuscript contains PDF figures)
+        _check_and_offer_poppler_installation(console, quiet, verbose)
+
         # Perform export
         docx_path = exporter.export()
 

rxiv_maker/cli/commands/upgrade.py

@@ -1,68 +1,18 @@
 """Upgrade command for rxiv-maker CLI."""
 
-import subprocess  # nosec B404 - needed for executing upgrade commands
 import sys
 
 import click
-from henriqueslab_updater import force_update_check
+from henriqueslab_updater import handle_upgrade_workflow
 from rich.console import Console
 
 from ... import __version__
-from ...utils.changelog_parser import fetch_and_format_changelog
-from ...utils.install_detector import detect_install_method, get_friendly_install_name, get_upgrade_command
-from ..interactive import prompt_confirm
+from ...utils.install_detector import detect_install_method
+from ...utils.rich_upgrade_notifier import RxivUpgradeNotifier
 
 console = Console()
 
 
-def _display_changelog(console: Console, current_version: str, latest_version: str) -> None:
-    """Display changelog summary for version range.
-
-    Args:
-        console: Rich console for output
-        current_version: Current installed version
-        latest_version: Latest available version
-    """
-    console.print("\n📋 What's changing:", style="bold blue")
-
-    # Fetch changelog summary
-    summary, error = fetch_and_format_changelog(
-        current_version=current_version,
-        latest_version=latest_version,
-        highlights_per_version=3,
-    )
-
-    if error:
-        console.print("   Unable to fetch changelog details", style="dim yellow")
-        console.print(
-            f"   View online: https://github.com/henriqueslab/rxiv-maker/releases/tag/v{latest_version}",
-            style="dim blue",
-        )
-        return
-
-    if summary:
-        # Display the changelog with proper formatting
-        for line in summary.split("\n"):
-            if line.startswith("⚠️"):
-                # Highlight breaking changes prominently
-                console.print(line, style="bold red")
-            elif line.startswith("What's New:"):
-                console.print(line, style="bold cyan")
-            elif line.startswith("  v"):
-                # Version headers
-                console.print(line, style="bold yellow")
-            elif line.strip().startswith(("✨", "🔄", "🐛", "🗑️", "🔒", "📝")):
-                # Change items
-                console.print(f"   {line.strip()}", style="white")
-            elif line.strip().startswith("•"):
-                # Breaking change items
-                console.print(f"   {line.strip()}", style="yellow")
-            elif line.strip():
-                console.print(f"   {line}", style="dim")
-    else:
-        console.print("   No detailed changelog available", style="dim")
-
-
 @click.command()
 @click.option("--yes", "-y", is_flag=True, help="Skip confirmation prompt")
 @click.option("--check-only", "-c", is_flag=True, help="Only check for updates, don't upgrade")
@@ -72,93 +22,31 @@ def upgrade(ctx: click.Context, yes: bool, check_only: bool) -> None:
 
     This command automatically detects how rxiv-maker was installed
     (Homebrew, pip, uv, pipx, etc.) and runs the appropriate upgrade command.
+
+    Examples:
+        rxiv upgrade              # Check and upgrade with confirmation
+        rxiv upgrade --yes        # Upgrade without confirmation
+        rxiv upgrade --check-only # Only check for updates
     """
-    # Detect installation method
+    # Handle development installations specially
     install_method = detect_install_method()
-    install_name = get_friendly_install_name(install_method)
-
-    console.print(f"🔍 Detected installation method: {install_name}", style="blue")
-
-    # Handle development installations
     if install_method == "dev":
         console.print("⚠️  Development installation detected", style="yellow")
         console.print("   To update, pull the latest changes from git:", style="yellow")
-        console.print("   cd <repo> && git pull && uv sync", style="yellow")
+        console.print("   [cyan]cd <repo> && git pull && uv sync[/cyan]", style="yellow")
         sys.exit(0)
 
-    # Check for updates
-    console.print("🔍 Checking for updates...", style="blue")
-    try:
-        update_available, latest_version = force_update_check()
-
-        if not update_available:
-            console.print(f"✅ You already have the latest version ({__version__})", style="green")
-            sys.exit(0)
-
-        console.print(f"📦 Update available: {__version__} → {latest_version}", style="green")
-
-        # Fetch and display changelog
-        _display_changelog(console, __version__, latest_version)
-
-        if check_only:
-            upgrade_cmd = get_upgrade_command(install_method)
-            console.print(f"\n   Run: {upgrade_cmd}", style="blue")
-            sys.exit(0)
-
-    except Exception as e:
-        console.print(f"⚠️  Could not check for updates: {e}", style="yellow")
-        console.print("   Proceeding with upgrade attempt...", style="yellow")
-        latest_version = "latest"
-
-    # Get upgrade command
-    upgrade_cmd = get_upgrade_command(install_method)
-
-    # Show confirmation
-    if not yes:
-        console.print(f"\n📦 About to run: {upgrade_cmd}", style="blue")
-        if not prompt_confirm("Do you want to continue?", default=True):
-            console.print("❌ Upgrade cancelled", style="yellow")
-            sys.exit(0)
-
-    # Execute upgrade command directly
-    console.print("\n🚀 Upgrading rxiv-maker...", style="blue")
-    console.print(f"   Running: {upgrade_cmd}", style="dim")
-
-    try:
-        # Split command for safer execution without shell=True
-        import shlex
-
-        cmd_parts = shlex.split(upgrade_cmd)
-        result = subprocess.run(
-            cmd_parts,
-            check=True,
-            capture_output=False,
-            timeout=300,
-        )  # nosec B603 - upgrade_cmd comes from trusted install_detector module
-        success = result.returncode == 0
-        error = None
-    except subprocess.CalledProcessError as e:
-        success = False
-        error = f"Command failed with exit code {e.returncode}"
-    except subprocess.TimeoutExpired:
-        success = False
-        error = "Upgrade timed out after 5 minutes"
-    except Exception as e:
-        success = False
-        error = str(e)
-
-    if success:
-        console.print("\n✅ Upgrade completed successfully!", style="green")
-        console.print("   Run 'rxiv --version' to verify the installation", style="blue")
+    # Use centralized upgrade workflow
+    notifier = RxivUpgradeNotifier(console)
+    success, error = handle_upgrade_workflow(
+        package_name="rxiv-maker",
+        current_version=__version__,
+        check_only=check_only,
+        skip_confirmation=yes,
+        notifier=notifier,
+        github_org="HenriquesLab",
+        github_repo="rxiv-maker",
+    )
 
-        # Show what's new in the upgraded version
-        if latest_version != "latest":
-            console.print(f"\n🎉 What's new in v{latest_version}:", style="bold green")
-            console.print(
-                f"   View full changelog: https://github.com/henriqueslab/rxiv-maker/releases/tag/v{latest_version}",
-                style="blue",
-            )
-    else:
-        console.print(f"\n❌ Upgrade failed: {error}", style="red")
-        console.print(f"   Try running manually: {upgrade_cmd}", style="yellow")
+    if not success and error:
         sys.exit(1)

rxiv_maker/core/managers/dependency_manager.py

@@ -487,6 +487,18 @@ class DependencyManager:
                 )
             )
 
+        # Poppler utilities for PDF to image conversion (DOCX export)
+        self.register_dependency(
+            DependencySpec(
+                name="pdftoppm",
+                type=DependencyType.SYSTEM_BINARY,
+                required=False,  # Only needed for DOCX export with PDF figures
+                alternatives=["pdfinfo"],
+                contexts={"docx", "export"},
+                install_hint="macOS: brew install poppler | Linux: sudo apt install poppler-utils",
+            )
+        )
+
     def register_dependency(self, spec: DependencySpec) -> None:
         """Register a dependency specification.
 

rxiv_maker/exporters/docx_exporter.py

@@ -318,9 +318,13 @@ class DocxExporter:
             # Get DOI from entry
             doi = entry.fields.get("doi")
 
-            # TODO: Implement DOI resolution if requested and DOI missing
-            # if self.resolve_dois and not doi:
-            #     doi = self._resolve_doi_from_metadata(entry)
+            # Attempt DOI resolution if requested and DOI missing
+            if self.resolve_dois and not doi:
+                doi = self._resolve_doi_from_metadata(entry)
+                if doi:
+                    # Store in entry for this export
+                    entry.fields["doi"] = doi
+                    logger.info(f"Resolved DOI for {key}: {doi}")
 
             # Format entry (full format for DOCX bibliography)
             formatted = format_bibliography_entry(entry, doi, slim=False, author_format=self.author_format)
@@ -332,6 +336,99 @@ class DocxExporter:
 
         return bibliography
 
+    def _resolve_doi_from_metadata(self, entry) -> str | None:
+        """Resolve DOI from entry metadata using CrossRef API.
+
+        Args:
+            entry: Bibliography entry to resolve DOI for
+
+        Returns:
+            Resolved DOI if found, None otherwise
+        """
+        import requests
+
+        # Try to construct a search query from available fields
+        title = entry.fields.get("title", "").strip()
+        year = entry.fields.get("year", "").strip()
+
+        if not title:
+            logger.debug(f"Cannot resolve DOI for {entry.key}: no title")
+            return None
+
+        # Clean title for search (remove LaTeX commands, braces, etc.)
+        search_title = self._clean_title_for_search(title)
+
+        # Try CrossRef search API
+        try:
+            url = "https://api.crossref.org/works"
+            params = {
+                "query.title": search_title,
+                "rows": 5,  # Get top 5 results
+            }
+
+            response = requests.get(url, params=params, timeout=10)
+
+            if response.status_code == 200:
+                data = response.json()
+                items = data.get("message", {}).get("items", [])
+
+                # Find best match
+                for item in items:
+                    item_title = item.get("title", [""])[0].lower()
+                    search_title_lower = search_title.lower()
+
+                    # Simple similarity check - titles should be very similar
+                    if item_title and (search_title_lower in item_title or item_title in search_title_lower):
+                        # Verify year matches if available
+                        if year:
+                            item_year = item.get("published", {}).get("date-parts", [[None]])[0][0]
+                            if item_year and str(item_year) != year:
+                                continue
+
+                        doi = item.get("DOI")
+                        if doi:
+                            logger.info(f"Resolved DOI for {entry.key}: {doi}")
+                            return doi
+
+            logger.debug(f"Could not resolve DOI for {entry.key} via CrossRef")
+            return None
+
+        except requests.exceptions.Timeout:
+            logger.debug(f"CrossRef API timeout resolving DOI for {entry.key}")
+            return None
+        except requests.exceptions.ConnectionError:
+            logger.debug(f"CrossRef API connection error for {entry.key}")
+            return None
+        except Exception as e:
+            logger.debug(f"Error resolving DOI for {entry.key}: {e}")
+            return None
+
+    def _clean_title_for_search(self, title: str) -> str:
+        """Clean title for CrossRef search by removing LaTeX commands.
+
+        Args:
+            title: Raw title from BibTeX entry
+
+        Returns:
+            Cleaned title suitable for search
+        """
+        import re
+
+        # Remove LaTeX commands
+        title = re.sub(r"\\[a-zA-Z]+\{([^}]*)\}", r"\1", title)  # \textit{foo} -> foo
+        title = re.sub(r"\\[a-zA-Z]+", "", title)  # \LaTeX -> LaTeX
+
+        # Remove braces
+        title = title.replace("{", "").replace("}", "")
+
+        # Remove special characters
+        title = re.sub(r"[^a-zA-Z0-9\s\-]", " ", title)
+
+        # Normalize whitespace
+        title = " ".join(title.split())
+
+        return title.strip()
+
     def _get_metadata(self) -> Dict[str, Any]:
         """Extract metadata for title page.
 

rxiv_maker/exporters/docx_writer.py

@@ -404,6 +404,19 @@ class DocxWriter:
         paragraph_format = paragraph.paragraph_format
         paragraph_format.left_indent = Pt(36)  # Indent code blocks
 
+    def _check_poppler_availability(self) -> bool:
+        """Check if poppler is available for PDF conversion.
+
+        Returns:
+            True if poppler is available, False otherwise
+        """
+        from ..core.managers.dependency_manager import DependencyStatus, get_dependency_manager
+
+        manager = get_dependency_manager()
+        result = manager.check_dependency("pdftoppm")
+
+        return result.status == DependencyStatus.AVAILABLE
+
     def _add_figure(self, doc: Document, section: Dict[str, Any], figure_number: int = None):
         """Add figure to document with caption.
 
@@ -425,9 +438,31 @@ class DocxWriter:
         if not figure_path.exists():
             logger.warning(f"Figure file not found: {figure_path}")
         elif figure_path.suffix.lower() == ".pdf":
-            # Convert PDF to image
-            img_source = convert_pdf_to_image(figure_path)
-            logger.debug(f"  PDF converted: {img_source is not None}")
+            # Check poppler availability first (cached after first check)
+            if not hasattr(self, "_poppler_checked"):
+                self._poppler_available = self._check_poppler_availability()
+                self._poppler_checked = True
+
+                if not self._poppler_available:
+                    logger.warning(
+                        "Poppler not installed - PDF figures will be shown as placeholders. "
+                        "Install with: brew install poppler (macOS) or sudo apt install poppler-utils (Linux)"
+                    )
+
+            if self._poppler_available:
+                # Convert PDF to image
+                try:
+                    from pdf2image.exceptions import PDFInfoNotInstalledError, PopplerNotInstalledError
+
+                    img_source = convert_pdf_to_image(figure_path)
+                    logger.debug(f"  PDF converted: {img_source is not None}")
+                except (PopplerNotInstalledError, PDFInfoNotInstalledError) as e:
+                    logger.error(f"Poppler utilities not found: {e}")
+                    img_source = None
+                    # Update our cached status
+                    self._poppler_available = False
+            else:
+                img_source = None
         elif figure_path.suffix.lower() in [".png", ".jpg", ".jpeg", ".gif", ".bmp"]:
             # Use image file directly
             img_source = str(figure_path)

rxiv_maker/utils/bst_generator.py

@@ -81,21 +81,41 @@ def generate_bst_file(format_type: str, output_dir: Path) -> Path:
     except IOError as e:
         raise IOError(f"Failed to read template .bst file: {e}") from e
 
-    # Replace the format string on line 222
+    # Replace the format string in the format.names function (line ~222)
     # The line looks like: s nameptr "{ff~}{vv~}{ll}{, jj}" format.name$ 't :=
-    # We need to replace the format string in quotes
-    pattern = r'(s\s+nameptr\s+")([^"]+)("\s+format\.name\$)'
+    # We need to replace ONLY in format.names, NOT in format.full.names
+    #
+    # Strategy: Match the FUNCTION {format.names} block specifically
+    # This ensures we don't modify format.full.names which is used for citation labels
+    #
+    # Pattern explanation:
+    # 1. Match "FUNCTION {format.names}" to find the start of the function
+    # 2. Use non-greedy match (.*?) to capture until we find our target line
+    # 3. Match and capture the format string in quotes
+    # 4. This avoids matching format.full.names which appears later in the file
+    pattern = r'(FUNCTION\s+\{format\.names\}.*?s\s+nameptr\s+")([^"]+)("\s+format\.name\$)'
     replacement = rf"\1{format_string}\3"
 
-    modified_content, num_subs = re.subn(pattern, replacement, bst_content)
+    modified_content, num_subs = re.subn(pattern, replacement, bst_content, flags=re.DOTALL)
 
     if num_subs == 0:
-        logger.warning("No format string pattern found in .bst file. The .bst file may have been modified.")
+        logger.warning(
+            "No format string pattern found in format.names function. "
+            "The .bst file structure may have changed. "
+            "Citation formatting may not work as expected."
+        )
         # Still write the file but log a warning
     elif num_subs > 1:
-        logger.warning(
-            f"Found {num_subs} format string patterns in .bst file. Expected only 1. All have been replaced."
+        # This should never happen with the new pattern, but keep the check
+        logger.error(
+            f"Found {num_subs} matches in .bst file. Expected exactly 1. "
+            "This indicates an unexpected .bst file structure. "
+            "Please report this issue."
         )
+        raise ValueError(f"Unexpected .bst file structure: found {num_subs} matches for format.names, expected 1")
+    else:
+        # Success - exactly one match
+        logger.debug(f"Successfully updated format.names function with format '{format_type}'")
 
     # Create output directory if it doesn't exist
     output_dir = Path(output_dir)

rxiv_maker/utils/docx_helpers.py

@@ -8,6 +8,7 @@ This module provides utility functions for DOCX generation including:
 """
 
 import io
+import logging
 import re
 from pathlib import Path
 from typing import Optional
@@ -18,6 +19,8 @@ from rxiv_maker.utils.author_name_formatter import format_author_list
 
 from ..utils.bibliography_parser import BibEntry
 
+logger = logging.getLogger(__name__)
+
 
 def remove_yaml_header(content: str) -> str:
     r"""Remove YAML frontmatter from markdown content.
@@ -395,6 +398,12 @@ def convert_pdf_to_image(pdf_path: Path, dpi: int = 150, max_width: int = 6) ->
     """
     try:
         from pdf2image import convert_from_path
+        from pdf2image.exceptions import (
+            PDFInfoNotInstalledError,
+            PDFPageCountError,
+            PDFSyntaxError,
+            PopplerNotInstalledError,
+        )
 
         # Convert first page of PDF to image
         images = convert_from_path(
@@ -427,7 +436,19 @@ def convert_pdf_to_image(pdf_path: Path, dpi: int = 150, max_width: int = 6) ->
 
         return img_bytes
 
+    except (PopplerNotInstalledError, PDFInfoNotInstalledError):
+        # Re-raise poppler errors so caller can handle them appropriately
+        # (e.g., CLI can offer to install poppler)
+        raise
+    except PDFSyntaxError as e:
+        # PDF file is malformed/corrupted
+        logger.warning(f"PDF file appears to be corrupted: {pdf_path.name} - {e}")
+        return None
+    except PDFPageCountError as e:
+        # Issue getting page count
+        logger.warning(f"Could not determine PDF page count for {pdf_path.name}: {e}")
+        return None
     except Exception as e:
-        # Log error but don't crash - return None to indicate failure
-        print(f"Warning: Failed to convert PDF to image: {e}")
+        # Other unexpected errors
+        logger.warning(f"Failed to convert {pdf_path.name} to image: {e}")
         return None

rxiv_maker/utils/rich_upgrade_notifier.py

@@ -0,0 +1,162 @@
+"""Rich console adapter for upgrade notifications in rxiv-maker."""
+
+import click
+from rich.console import Console
+
+
+class RxivUpgradeNotifier:
+    """Adapt Rich console to UpgradeNotifier protocol for rxiv-maker.
+
+    Integrates with rxiv-maker's changelog parser to show rich change summaries.
+    """
+
+    def __init__(self, console: Console):
+        """Initialize with Rich console instance.
+
+        Args:
+            console: Rich Console instance for styled output
+        """
+        self.console = console
+
+    def show_checking(self) -> None:
+        """Show 'checking for updates' message."""
+        self.console.print("🔍 Checking for updates...", style="blue")
+
+    def show_version_check(self, current: str, latest: str, available: bool) -> None:
+        """Show version check results.
+
+        Args:
+            current: Current installed version
+            latest: Latest available version
+            available: Whether an update is available
+        """
+        if available:
+            self.console.print(
+                f"📦 Update available: [cyan]v{current}[/cyan] → [green bold]v{latest}[/green bold]",
+                style="yellow",
+            )
+        else:
+            self.console.print(
+                f"✅ You already have the latest version ([cyan]v{current}[/cyan])",
+                style="green",
+            )
+
+    def show_update_info(self, current: str, latest: str, release_url: str) -> None:
+        """Show update available information with changelog integration.
+
+        Args:
+            current: Current version
+            latest: Latest version
+            release_url: URL to release notes
+        """
+        # Import here to avoid circular dependencies
+        from .changelog_parser import fetch_and_format_changelog
+
+        # Fetch and display changelog
+        summary, error = fetch_and_format_changelog(
+            current_version=current,
+            latest_version=latest,
+            highlights_per_version=3,
+        )
+
+        if summary and not error:
+            self.console.print("\n📋 What's changing:", style="bold blue")
+            # Display changelog - format_summary returns rich-formatted text
+            # Parse and display with proper styling
+            for line in summary.split("\n"):
+                if line.startswith("⚠️"):
+                    # Highlight breaking changes prominently
+                    self.console.print(line, style="bold red")
+                elif "What's New:" in line or "What's changing:" in line:
+                    self.console.print(line, style="bold cyan")
+                elif line.strip().startswith("v"):
+                    # Version headers
+                    self.console.print(line, style="bold yellow")
+                elif line.strip().startswith(("✨", "🔄", "🐛", "🗑️", "🔒", "📝")):
+                    # Change items with emojis
+                    self.console.print(f"   {line.strip()}", style="white")
+                elif line.strip().startswith("•"):
+                    # Breaking change items
+                    self.console.print(f"   {line.strip()}", style="yellow")
+                elif line.strip():
+                    self.console.print(f"   {line}", style="dim")
+        else:
+            # Fallback if changelog unavailable
+            self.console.print(
+                f"\nView release notes: [link]{release_url}[/link]",
+                style="blue",
+            )
+
+    def show_installer_info(self, friendly_name: str, command: str) -> None:
+        """Show detected installer information.
+
+        Args:
+            friendly_name: Human-readable installer name
+            command: The upgrade command that will be executed
+        """
+        self.console.print()
+        self.console.print(
+            f"🔍 Detected installation method: [bold]{friendly_name}[/bold]",
+            style="blue",
+        )
+        self.console.print(f"📦 Running: [yellow]{command}[/yellow]")
+
+    def show_success(self, version: str) -> None:
+        """Show successful upgrade message.
+
+        Args:
+            version: Version that was successfully installed
+        """
+        self.console.print()
+        self.console.print("✅ Upgrade completed successfully!", style="green bold")
+        self.console.print(f"   Now running: [green]v{version}[/green]")
+        self.console.print()
+        self.console.print("   Run [blue]'rxiv --version'[/blue] to verify the installation", style="dim")
+
+    def show_error(self, error: str | None) -> None:
+        """Show upgrade error message.
+
+        Args:
+            error: Error message or None
+        """
+        self.console.print()
+        self.console.print("❌ Upgrade failed", style="red bold")
+        if error:
+            self.console.print(f"   {error}", style="red")
+
+    def show_manual_instructions(self, install_method: str) -> None:
+        """Show manual upgrade instructions.
+
+        Args:
+            install_method: The detected installation method
+        """
+        self.console.print("\n💡 Try running manually:", style="yellow bold")
+
+        if install_method == "homebrew":
+            self.console.print("   [cyan]brew update && brew upgrade rxiv-maker[/cyan]")
+        elif install_method == "pipx":
+            self.console.print("   [cyan]pipx upgrade rxiv-maker[/cyan]")
+        elif install_method == "uv":
+            self.console.print("   [cyan]uv tool upgrade rxiv-maker[/cyan]")
+        elif install_method == "dev":
+            self.console.print("   [cyan]cd <repo> && git pull && uv sync[/cyan]", style="dim")
+        else:
+            self.console.print("   [cyan]pip install --upgrade rxiv-maker[/cyan]")
+            self.console.print("   [dim]# Or with --user flag:[/dim]")
+            self.console.print("   [cyan]pip install --upgrade --user rxiv-maker[/cyan]")
+
+    def confirm_upgrade(self, version: str) -> bool:
+        """Prompt user for confirmation using click.
+
+        Args:
+            version: Version to upgrade to
+
+        Returns:
+            True if user confirms, False otherwise
+        """
+        try:
+            self.console.print()
+            return click.confirm(f"Upgrade rxiv-maker to v{version}?", default=True)
+        except (KeyboardInterrupt, EOFError):
+            self.console.print("\n⚠️  Upgrade cancelled.", style="yellow")
+            return False

{rxiv_maker-1.16.6.dist-info → rxiv_maker-1.16.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rxiv-maker
-Version: 1.16.6
+Version: 1.16.8
 Summary: Write scientific preprints in Markdown. Generate publication-ready PDFs efficiently.
 Project-URL: Homepage, https://github.com/HenriquesLab/rxiv-maker
 Project-URL: Documentation, https://github.com/HenriquesLab/rxiv-maker#readme
@@ -27,7 +27,7 @@ Requires-Python: >=3.10
 Requires-Dist: click>=8.0.0
 Requires-Dist: crossref-commons>=0.0.7
 Requires-Dist: gitpython>=3.1.0
-Requires-Dist: henriqueslab-updater>=1.1.3
+Requires-Dist: henriqueslab-updater>=1.2.0
 Requires-Dist: latex2mathml>=3.78.0
 Requires-Dist: matplotlib>=3.7.0
 Requires-Dist: numpy>=1.24.0
@@ -358,9 +358,14 @@ rxiv config --non-interactive  # Show current settings
 
 ### Maintenance
 ```bash
-rxiv upgrade               # Upgrade to latest version
-rxiv changelog             # View changelog and release notes
-rxiv changelog --recent 5  # View last 5 versions
+# Upgrade commands (auto-detects Homebrew, pip, uv, pipx)
+rxiv upgrade                 # Interactive upgrade with confirmation
+rxiv upgrade --yes           # Upgrade without confirmation
+rxiv upgrade --check-only    # Check for updates only
+
+# Changelog and version information
+rxiv changelog               # View changelog and release notes
+rxiv changelog --recent 5    # View last 5 versions
 ```
 
 > **💡 CI/Automation Note:** All interactive commands support non-interactive mode or configuration files for use in CI/CD pipelines and automated workflows. Use `--non-interactive` flag or configure via `~/.rxiv-maker/config` for non-TTY environments.

{rxiv_maker-1.16.6.dist-info → rxiv_maker-1.16.8.dist-info}/RECORD

@@ -1,5 +1,5 @@
 rxiv_maker/__init__.py,sha256=p04JYC5ZhP6dLXkoWVlKNyiRvsDE1a4C88f9q4xO3tA,3268
-rxiv_maker/__version__.py,sha256=qf0GMhAIH5L_wI59eHcfpHtgoZxaqziVuvj0M1daj0g,51
+rxiv_maker/__version__.py,sha256=FDIQKkG-uf-zpYYZrGmwOD83CED6k3EcIvKFr382p-g,51
 rxiv_maker/rxiv_maker_cli.py,sha256=9Lu_mhFPXwx5jzAR6StCNxwCm_fkmP5qiOYdNuh_AwI,120
 rxiv_maker/validate.py,sha256=AIzgP59KbCQJqC9WIGfUdVv0xI6ud9g1fFznQkaGz5Q,9373
 rxiv_maker/cli/__init__.py,sha256=Jw0DTFUSofN-02xpVrt1UUzRcgH5NNd-GPNidhmNwpU,77
@@ -19,7 +19,7 @@ rxiv_maker/cli/commands/clean.py,sha256=8yQVbhHLQX0xIM7MD-0sG_agX7xVxzl1AkqPzZRR
 rxiv_maker/cli/commands/completion.py,sha256=TKc6QPEFVN8qQsu2LbPEZvsSZr_CBvyekkfTItTDI6A,789
 rxiv_maker/cli/commands/config.py,sha256=adN4ci_EB-NZsNXNY9FlFxE6CLVxblunX1dobrjNef0,33761
 rxiv_maker/cli/commands/create_repo.py,sha256=jWPwT1Ai7XBhFAi9JmSAobdFYXPlSgQCD-gx_ZUNwEo,9947
-rxiv_maker/cli/commands/docx.py,sha256=yFJxwDyQ8F6M9n4R6AUx0lq03iMQevuI_9eY2t6ke24,2849
+rxiv_maker/cli/commands/docx.py,sha256=memJ5SeSQ8rD_wwOH9gUs1TgJUpP25_gIKEu8lKn5nQ,5896
 rxiv_maker/cli/commands/figures.py,sha256=WraC0BjwxKImzCwt1A3vWs8_T4w2misP1eeW6aznpCw,3250
 rxiv_maker/cli/commands/get_rxiv_preprint.py,sha256=nSPuFpS5xZ9VaUrmwnFZ5RCAAjj0ORAj8x_EJmH0Xtg,8543
 rxiv_maker/cli/commands/init.py,sha256=2UiXtk7a5bklqwevWwhbL9lU1ASBxUwzm7JdrINHcGA,1797
@@ -29,7 +29,7 @@ rxiv_maker/cli/commands/repos.py,sha256=SQ9nuhSkyHKFPYn_TrOxyQoGdDRI-OBOgUSGJpRu
 rxiv_maker/cli/commands/repos_search.py,sha256=6sUMvyHlHEX1p88hPtu0_Hf8z6JpOinJ53l9ZI-rirc,7743
 rxiv_maker/cli/commands/setup.py,sha256=9ue4bDETpSPGVkWFDfpuTDsysax5-QKGxmt42Gb7oeU,2294
 rxiv_maker/cli/commands/track_changes.py,sha256=omf_77A7htRSa8naUEPTTtUTxrSwMpzHFOuU0j1xAJw,1163
-rxiv_maker/cli/commands/upgrade.py,sha256=VJ1snYyLGrb5-snF4olfsMwfQsuKkAbXEr8aQ88WYYE,6349
+rxiv_maker/cli/commands/upgrade.py,sha256=UpdqEQwbNYmDMbSrYGv_pVd-7u8PPT3US5RVENhKK4w,1852
 rxiv_maker/cli/commands/validate.py,sha256=3JghFQevJvQDQII4p_QWbQXMEUyDpM-t9-WxtaT4edo,1629
 rxiv_maker/cli/commands/version.py,sha256=VMlfSxxsrZH02d24MXLUDZfHBW39yZRpWxUpMhQ-X0Y,2737
 rxiv_maker/cli/framework/__init__.py,sha256=4FPXdP8J6v4eeEn46mwY0VtnwxjR1jnW_kTrXykQlQs,2704
@@ -80,7 +80,7 @@ rxiv_maker/core/cache/secure_cache_utils.py,sha256=EejPWvxw_mUPqO0TRBHYYTsLXWZEU
 rxiv_maker/core/managers/__init__.py,sha256=sh4ZuZH4YrAu4XTiN9ky1-tQQASKiSTY0udJJAzDRcU,950
 rxiv_maker/core/managers/cache_manager.py,sha256=8btUaRDYPOrUynHWBMz7RVeS9xcpUoyhemFNUi8NqpQ,21893
 rxiv_maker/core/managers/config_manager.py,sha256=DdM-3_mfrjHFkPQ2vOmpQnXaoSJU-ianVwUvCEIwZss,18829
-rxiv_maker/core/managers/dependency_manager.py,sha256=DwVRcvk4JcZGzYc-K6ue7aGfw8fSnne50pPI_8Arlzw,25800
+rxiv_maker/core/managers/dependency_manager.py,sha256=qtUR4sQD2x1zv4Fi77d6ThwPx9eHZ9_ZyNy0hRpIKKQ,26308
 rxiv_maker/core/managers/execution_manager.py,sha256=cEDS0KyWBHf_N74Fc8MC4VRXxmEcaz_DJtyWO5-o628,29585
 rxiv_maker/core/managers/file_manager.py,sha256=SVRnP1JQoGCAms3E7iSpOp_RG60P36Qk9HGAmJDaFvE,18641
 rxiv_maker/core/managers/install_manager.py,sha256=8HChOfbm5-uXsksKMDqmgrYNMJJtyDoL2RDNpbFwhwc,15533
@@ -106,8 +106,8 @@ rxiv_maker/engines/operations/validate_pdf.py,sha256=qyrtL752Uap3i6ntQheY570soVj
 rxiv_maker/exporters/__init__.py,sha256=NcTD1SDb8tTgsHhCS1A7TVEZncyWbDRTa6sJIdLqcsE,350
 rxiv_maker/exporters/docx_citation_mapper.py,sha256=Qp3IEqrR6lQGQPQ4JeGdOCWeg97XBbVCKdX1gtX9XfY,4584
 rxiv_maker/exporters/docx_content_processor.py,sha256=3srXfq4lC_FJpTAfu-WB930WheSm6rCy-vNUtFlsflY,23878
-rxiv_maker/exporters/docx_exporter.py,sha256=i2G_AF-Co4AOD6ZdRzDZ7VgcJLdCmxu-Fn3SykvBywQ,15152
-rxiv_maker/exporters/docx_writer.py,sha256=qI_0JklqAxF_TUHxO3wPopZpJ44O2qYjMPOptrnU0XM,41915
+rxiv_maker/exporters/docx_exporter.py,sha256=Q18TuZCbx6fzAs1f9G2A9h5N2Gw5qhCrL7a2NKXizg8,18672
+rxiv_maker/exporters/docx_writer.py,sha256=CW2Xu9-vpuEct9344bM8ofGkCiWlAYijoXVzZ7MQZ6g,43460
 rxiv_maker/install/__init__.py,sha256=kAB6P-12IKg_K1MQ-uzeC5IR11O2cNxj0t_2JMhooZs,590
 rxiv_maker/install/dependency_handlers/__init__.py,sha256=NN9dP1usXpYgLpSw0uEnJ6ugX2zefihVjdyDdm1k-cE,231
 rxiv_maker/install/dependency_handlers/latex.py,sha256=xopSJxYkg3D63rH7RoVLN-Ykl87AZqhlUrrG3m6LoWo,3304
@@ -147,11 +147,11 @@ rxiv_maker/utils/__init__.py,sha256=4ya5VR8jqRqUChlnUeMeeetOuWV-gIvjPwcE1u_1OnI,
 rxiv_maker/utils/author_name_formatter.py,sha256=UjvarbyQm89EUIYqckygx3g37o-EcNyvipBtY8GJDxs,10222
 rxiv_maker/utils/bibliography_checksum.py,sha256=Jh4VILSpGQ5KJ9UBCUb7oFy6lZ9_ncXD87vEXxw5jbY,10270
 rxiv_maker/utils/bibliography_parser.py,sha256=WZIQoEpVwdbLmbkw9FdkVgoLE5GX7itqnzPnEEb_fFU,6846
-rxiv_maker/utils/bst_generator.py,sha256=kS4k_cc2GNm3l-bwaVU7uffWbH3VDzHwgCXHn7Ro9xI,5002
+rxiv_maker/utils/bst_generator.py,sha256=m69JWMIvf9eRiHcaWB-8D3DQCDO8flVIYbOBMuzV-F0,6097
 rxiv_maker/utils/changelog_parser.py,sha256=WCDp9Iy6H6_3nC6FB7RLt6i00zuCyvU17sCU4e3pqCY,11954
 rxiv_maker/utils/citation_utils.py,sha256=spIgVxPAN6jPvoG-eOE00rVX_buUGKnUjP1Fhz31sl4,5134
 rxiv_maker/utils/dependency_checker.py,sha256=EdyIvk-W_bhC1DJCpFw5ePhjEU74C9j7RYMm06unBMA,14366
-rxiv_maker/utils/docx_helpers.py,sha256=jhxkrU80JjDJXDE3gNfsJt9PqLyByYDfymY_Jm9ZqoI,12860
+rxiv_maker/utils/docx_helpers.py,sha256=rNNnz3mhXymrTgQR4bZDnGwpUFylWVpfpJnY0bWnl30,13635
 rxiv_maker/utils/doi_resolver.py,sha256=8_oy5cTtklm1GCKXpn509yqYsu4P5gYbMjtfQ8dRgFA,10253
 rxiv_maker/utils/email_encoder.py,sha256=QMD5JbGNu68gD8SBdGHfNY8uCgbMzEcmzE1TCYDMgWY,5139
 rxiv_maker/utils/figure_checksum.py,sha256=PWgh2QAErNnnQCV-t-COACQXKICUaggAAIxhgHLCGNM,10748
@@ -165,6 +165,7 @@ rxiv_maker/utils/performance.py,sha256=EBDVNshSaeG7Nu-GCZtRAzTunGn4z_Bb2jEck045b
 rxiv_maker/utils/platform.py,sha256=DCD3gvm7_DBcT67gGIXhTDV5mPrBjWrL7R2JdsmIgng,17773
 rxiv_maker/utils/python_execution_reporter.py,sha256=l3hqLXtGAg_wKUlkikK1oaHPeBpoCkj3iR6i1fc11ys,10606
 rxiv_maker/utils/retry.py,sha256=aNsuc7HuxMwG4yubgX0GxIEZ0iF6_4lACusVMc0ZSXA,11026
+rxiv_maker/utils/rich_upgrade_notifier.py,sha256=aMqkx9l_2KtEiwVFdhOU4oqsAgdWQ86LuqWN4k_cTA0,6365
 rxiv_maker/utils/text_utils.py,sha256=ntovIx7qXB0LWO9OmCu7-rqTSfyEvthrTjYEJTbmZ_U,1972
 rxiv_maker/utils/tips.py,sha256=XHgbJkyFjYt5Pz-Rdz_yCjnRLguxIsHwdFmNSg323NA,8078
 rxiv_maker/utils/title_sync.py,sha256=C7NT80DgBJrS70mil6b7ghcZyKR2n5_MNlC6Yli_dXM,15094
@@ -187,8 +188,8 @@ rxiv_maker/validators/doi/metadata_comparator.py,sha256=euqHhKP5sHQAdZbdoAahUn6Y
 rxiv_maker/tex/template.tex,sha256=zrJ3aFfu8j9zkg1l375eE9w-j42P3rz16wMD3dSgi1I,1354
 rxiv_maker/tex/style/rxiv_maker_style.bst,sha256=jbVqrJgAm6F88cow5vtZuPBwwmlcYykclTm8RvZIo6Y,24281
 rxiv_maker/tex/style/rxiv_maker_style.cls,sha256=F2qtnS9mI6SwOIaVH76egXZkB2_GzbH4gCTG_ZcfCDQ,24253
-rxiv_maker-1.16.6.dist-info/METADATA,sha256=7_r-ZEzlmKCVaCu_a-Z8tg8pr4kzfI3tDbvfCbc1dCw,17950
-rxiv_maker-1.16.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-rxiv_maker-1.16.6.dist-info/entry_points.txt,sha256=ghCN0hI9A1GlG7QY5F6E-xYPflA8CyS4B6bTQ1YLop0,97
-rxiv_maker-1.16.6.dist-info/licenses/LICENSE,sha256=GSZFoPIhWDNJEtSHTQ5dnELN38zFwRiQO2antBezGQk,1093
-rxiv_maker-1.16.6.dist-info/RECORD,,
+rxiv_maker-1.16.8.dist-info/METADATA,sha256=3GydBaQKqwL3nUaxEPdNRRobVMhmb7hRvJW7e5qQ_gc,18177
+rxiv_maker-1.16.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+rxiv_maker-1.16.8.dist-info/entry_points.txt,sha256=ghCN0hI9A1GlG7QY5F6E-xYPflA8CyS4B6bTQ1YLop0,97
+rxiv_maker-1.16.8.dist-info/licenses/LICENSE,sha256=GSZFoPIhWDNJEtSHTQ5dnELN38zFwRiQO2antBezGQk,1093
+rxiv_maker-1.16.8.dist-info/RECORD,,