bibsync 0.3.2

A Rust package to automatically resolve, synchronize, and validate LaTeX citations across BibTeX databases
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

from __future__ import annotations

from pathlib import Path

import bibsync
import pytest

COMPLETE_ENTRY = """@article{smith2024,
  author = {Smith, Jane},
  title = {A Complete Entry},
  journal = {Journal of Local Fixtures},
  year = {2024}
}
"""


def test_sync_files_reports_existing_complete_bib_entry(tmp_path: Path) -> None:
    bibliography = tmp_path / "references.bib"
    bibliography.write_text(COMPLETE_ENTRY, encoding="utf-8")

    report = bibsync.sync_files([str(bibliography)], provider="inspire")

    assert report == {
        "output": str(bibliography),
        "added": [],
        "updated": [],
        "existing": ["smith2024"],
        "found_in_other": [],
        "unresolved": [],
        "unresolved_details": [],
        "changed": False,
        "check_mode": True,
    }
    assert bibliography.read_text(encoding="utf-8") == COMPLETE_ENTRY


def test_sync_files_accepts_underscore_update_mode_alias(tmp_path: Path) -> None:
    bibliography = tmp_path / "references.bib"
    bibliography.write_text(COMPLETE_ENTRY, encoding="utf-8")

    report = bibsync.sync_files(
        [str(bibliography)],
        provider="inspire",
        update_mode="preprints_only",
    )

    assert report["existing"] == ["smith2024"]
    assert report["changed"] is False


def test_sync_files_rejects_unknown_provider(tmp_path: Path) -> None:
    bibliography = tmp_path / "references.bib"
    bibliography.write_text(COMPLETE_ENTRY, encoding="utf-8")

    with pytest.raises(ValueError, match="provider must be"):
        bibsync.sync_files([str(bibliography)], provider="unknown")


def test_main_delegates_to_rust_cli(capfd: pytest.CaptureFixture[str]) -> None:
    exit_code = bibsync.main(["bibsync", "--version"])

    captured = capfd.readouterr()
    assert exit_code == 0
    assert captured.out.startswith("bibsync ")