luci package

luci.cli module

luci.acromerge module

luci.acromerge.format_acrodefs(acro_map: dict[str, str], command: str) → str

Format acrodefs into a single string for output.

Parameters:

• acro_map – Dictionary of short -> long definitions.

• command – The base command to emit, e.g. “acro” or “acrodef”.

Returns:

Formatted string of <command>{…} entries.

luci.acromerge.merge_acrodef_files(file_paths: list[Path]) → dict[str, tuple[str, str]]

Merge multiple LaTeX acro/acrodef files into a deduplicated dictionary.

Parameters:

file_paths – List of Path objects to LaTeX files.

Returns:

Dictionary of short -> long definitions.

luci.acromerge.merge_acronyms(files: list[Path], output: Path | None = None, command: str = 'acro')

Extract and merge acronyms from multiple LaTeX files into a single file.

luci.acromerge.parse_acrodefs_from_file(path: Path) → dict[str, tuple[str, str]]

Parse acro and acrodef entries from a LaTeX file, supporting the optional short-name form: acro{id}[short]{long}.

Parameters:

path – Path to the LaTeX file.

Returns:

Dictionary mapping id to (short, long) where short is optional.

luci.archive module

class luci.archive.BibStyle(*values)

Bases: Enum

biblatex = 'biblatex'

bibtex = 'bibtex'

luci.archive.add_bbl_file(archive: Path, main: str, deps: dict[str, Path])

luci.archive.archive(main: Path, output: Path | None = None, validate: bool = True, bbl: bool = False, bibstyle: BibStyle = BibStyle.bibtex)

Create a zip archive of a LaTeX project by flattening inputs.

Flattens includes and strips paths from common commands to collect local dependencies next to the main file, then zips them. With –validate, runs tectonic on the archive to ensure it compiles; with –bbl, includes generated .bbl files after a build.

luci.archive.create_archive(archive: str, files: dict[str, Path])

luci.archive.flatten_latex(file_path: Path, commands_to_flatten=['documentclass', 'includegraphics', 'addbibresource', 'bibliography', 'RequirePackage', 'usepackage', 'InputIfFileExists', 'templatetype'], root: Path | None = None, scratch=None)

Recursively flattens a LaTeX file by replacing input and include with actual content. Returns the flattened LaTeX as a string.

luci.archive.replace_citeauthor_commands(latex_text: str, bib_files: Iterable[Path], max_names: int = 2) → str

Replace citeauthor and citeauthorcite commands with author text.

• \citeauthor{foo} -> “<authors for foo>”

• \citeauthorcite{foo} -> “<authors for foo>cite{foo}”

When an entry has more than max_names authors, only the first last name is kept followed by “ et al.”. Otherwise, up to max_names last names are joined with “ and “.

Parameters:

• latex_text – The flattened LaTeX text.

• bib_files – Paths to .bib files referenced by the project.

• max_names – Maximum number of last names to display before using et al.

Returns:

Updated LaTeX text with citeauthor macros replaced.

luci.archive.strip_paths_from_command(latex_text: str, command: str) → tuple[str, dict[str, Path]]

Replaces command{path/to/file} with command{file} using pathlib, and returns a list of (original path, updated line) replacements.

Parameters:

• latex_text – The LaTeX document as a string.

• command – The command name without backslash, e.g., ‘includegraphics’.

Returns:

• Updated LaTeX text with paths stripped

• List of (original path, updated line) for each replacement

Return type:

A tuple

luci.archive.validate_archive(archive: Path, mainfile: str)

luci.bibtools module

luci.bibtools.merge_and_dedupe(bibfiles: list[Path], output: Path = PosixPath('merged.bib'), mapping: Path = PosixPath('duplicate_keys.json'))

Merge multiple BibTeX files and deduplicate using bibtex-tidy.

Writes the deduplicated BibTeX to –output and a JSON map of removed duplicate keys to kept keys to –mapping. Earlier files take precedence. Requires bibtex-tidy to be installed and on PATH.

luci.bibtools.merge_bibtex_files(bibfiles: list[Path], merged_path: Path)

Merge multiple BibTeX files into a single file (earlier takes precedence).

luci.bibtools.run_bibtex_tidy_dedupe(input_bib: Path) → tuple[str, dict[str, str]]

Run bibtex-tidy to deduplicate, returning (deduplicated text, old→new mapping).

luci.bibtools.strip_emojis(text: str) → str

Remove emoji characters from text.

luci.bibtools.update_citation(duplicate_keys: Path, files: list[Path])

Update LaTeX citation keys using a JSON mapping.

Use the mapping produced by merge-bibs (old→new keys) to rewrite citation commands (e.g. cite, citet) across one or more files.