fin-paper-convert

fin-paper-convert

Compile LaTeX manuscripts to publication-ready PDFs and generate submission variants (anonymous, arxiv, word) for the target journal.

Step 0: Pre-compilation Check

Before running LaTeX compilation, verify all components are ready:

# Check required files exist
ls -la output/fin-manuscript/draft_v1/
ls -la output/fin-manuscript/draft_v1/sections/ 2>/dev/null || echo "No sections dir"
ls -la output/fin-manuscript/draft_v1/figures/  2>/dev/null || echo "No figures dir"

# Check LaTeX installation
which xelatex pdflatex latexmk 2>/dev/null
latexmk --version 2>/dev/null || echo "latexmk not found"

# Check bibliography tool
which bibtex biber 2>/dev/null

#!/usr/bin/env python3
"""Pre-compilation validation for fin-paper-convert."""

import os
import re
from pathlib import Path
from dataclasses import dataclass
from typing import List, Optional, Tuple


@dataclass
class ValidationResult:
    ok: bool
    errors: List[str]
    warnings: List[str]
    missing_files: List[str]


def validate_latex_project(base_dir: str) -> ValidationResult:
    """
    Validate all required files and structure before compilation.
    """
    base = Path(base_dir)
    errors = []
    warnings = []
    missing = []
    
    # Check main.tex
    main_tex = base / "main.tex"
    if not main_tex.exists():
        missing.append(str(main_tex))
        errors.append("main.tex not found")
    
    # Check references.bib
    bib_file = base / "references.bib"
    if not bib_file.exists():
        missing.append(str(bib_file))
        errors.append("references.bib not found")
    else:
        # Count references
        bib_content = bib_file.read_text(encoding="utf-8")
        ref_count = len(re.findall(r'@\w+\{', bib_content))
        warnings.append(f"Found {ref_count} references in references.bib")
    
    # Check figures directory
    fig_dir = base / "figures"
    if not fig_dir.exists():
        warnings.append("figures/ directory not found (no figures will be included)")
    else:
        fig_files = list(fig_dir.glob("*.pdf")) + list(fig_dir.glob("*.png"))
        if not fig_files:
            warnings.append("No figure files (.pdf/.png) found in figures/")
    
    # Check sections directory
    sec_dir = base / "sections"
    if sec_dir.exists():
        tex_files = list(sec_dir.glob("*.tex"))
        if tex_files:
            warnings.append(f"Found {len(tex_files)} section .tex files")
    
    # Validate main.tex structure
    if main_tex.exists():
        content = main_tex.read_text(encoding="utf-8")
        
        # Check required packages
        if r'\documentclass' not in content:
            errors.append("main.tex missing \\documentclass")
        
        # Check bibliography commands
        if r'\bibliography' not in content and r'\addbibresource' not in content:
            warnings.append("No bibliography command found in main.tex")
        
        # Check input commands for sections
        if sec_dir.exists() and not any(r'\input{' in content for _ in [1]):
            warnings.append("No \\input{} commands found — sections may not be included")
    
    return ValidationResult(
        ok=len(errors) == 0,
        errors=errors,
        warnings=warnings,
        missing_files=missing,
    )