codetwin 0.1.10

A code to diagram/documentation generator.
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

"""Sync pyproject.toml metadata from Cargo.toml.

Keeps Python package metadata aligned with the Rust crate.
Run via: uv run -- python scripts/sync_pyproject.py
"""

from __future__ import annotations

import pathlib
import sys

import tomllib

ROOT = pathlib.Path(__file__).resolve().parents[1]
CARGO_TOML = ROOT / "Cargo.toml"
PYPROJECT_TOML = ROOT / "pyproject.toml"


def load_cargo_metadata() -> dict:
    with CARGO_TOML.open("rb") as handle:
        data = tomllib.load(handle)
    return data.get("package", {})


def update_pyproject_lines(lines: list[str], cargo: dict) -> list[str]:
    project_section = False
    urls_section = False

    name = cargo.get("name")
    version = cargo.get("version")
    description = cargo.get("description")
    authors = cargo.get("authors", [])
    repository = cargo.get("repository")
    documentation = cargo.get("documentation")

    updated = []
    for line in lines:
        stripped = line.strip()
        if stripped.startswith("[") and stripped.endswith("]"):
            project_section = stripped == "[project]"
            urls_section = stripped == "[project.urls]"

        if project_section and stripped.startswith("name =") and name:
            updated.append(f"  name = \"{name}\"\n")
            continue
        if project_section and stripped.startswith("version =") and version:
            updated.append(f"  version = \"{version}\"\n")
            continue
        if project_section and stripped.startswith("description =") and description:
            updated.append(f"  description = \"{description}\"\n")
            continue
        if project_section and stripped.startswith("authors =") and authors:
            author_name = authors[0]
            updated.append(f"  authors = [{{ name = \"{author_name}\" }}]\n")
            continue
        if urls_section and stripped.startswith("Homepage") and repository:
            updated.append(f"  Homepage      = \"{repository}\"\n")
            continue
        if urls_section and stripped.startswith("Documentation") and documentation:
            updated.append(f"  Documentation = \"{documentation}\"\n")
            continue

        updated.append(line)

    return updated


def main() -> int:
    if not CARGO_TOML.exists() or not PYPROJECT_TOML.exists():
        print("Missing Cargo.toml or pyproject.toml", file=sys.stderr)
        return 1

    cargo = load_cargo_metadata()
    lines = PYPROJECT_TOML.read_text(encoding="utf-8").splitlines(keepends=True)
    updated = update_pyproject_lines(lines, cargo)

    if updated != lines:
        PYPROJECT_TOML.write_text("".join(updated), encoding="utf-8")
        print("Updated pyproject.toml from Cargo.toml")
    else:
        print("pyproject.toml already matches Cargo.toml")

    return 0


if __name__ == "__main__":
    raise SystemExit(main())