python-docs-de/tools/sync_branches.py at sync-upstream-3.14 · python/python-docs-de · GitHub

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

#!/usr/bin/env python3

"""Gleicht Uebersetzungen zwischen zwei Branches ab -- Eintrag fuer Eintrag.

Unser Arbeitsmodell: gearbeitet wird in 3.15, von dort wird nach 3.14

zurueckgespiegelt. Dieses Skript macht den Abgleich nachvollziehbar, statt

eine Datei pauschal zu ueberschreiben.

Warum nicht einfach pomerge? pomerge kennt nur Quelle und Ziel. Es sieht

nicht, WER einen Eintrag zuletzt angefasst hat, und ueberschreibt deshalb

auch Arbeit, die nur im Zielbranch existiert. Dieses Skript vergleicht

beide Seiten gegen ihren gemeinsamen Vorfahren und unterscheidet damit:

nur die Quelle hat sich bewegt -> wird uebertragen

nur das Ziel hat sich bewegt -> bleibt unangetastet

beide haben sich bewegt -> Konflikt, wird gemeldet

Quelle ist leer oder fuzzy -> nie uebertragen

Der letzte Punkt ist wichtig: ein msgmerge kann eine Uebersetzung im

Zielbranch entfernt haben. Mit --leere-ziele werden genau diese Luecken

aus der Quelle wieder gefuellt.

Aufruf (im Repo, das ZIEL muss ausgecheckt sein):

python tools/sync_branches.py --von 3.15 # Trockenlauf

python tools/sync_branches.py --von 3.15 --apply

python tools/sync_branches.py --von 3.15 --leere-ziele --apply

python tools/sync_branches.py --von 3.15 --nur reference,library

python tools/sync_branches.py --von 3.15 -o konflikte.md

Ohne --apply wird nichts geschrieben. Konflikte werden nie automatisch

entschieden -- sie landen im Bericht und gehoeren von Hand geprueft.

"""

import argparse

import os

import subprocess

import sys

import tempfile

try:

import polib

except ImportError:

sys.exit("polib fehlt. Im aktiven venv installieren: pip install polib")

def git(*args, repo="."):

e = subprocess.run(["git", "--no-optional-locks", *args], cwd=repo,

capture_output=True, text=True)

return e.stdout if e.returncode == 0 else None

def karte(text):

"""{msgid: msgstr} aus einem PO-Text; fuzzy zaehlt als unuebersetzt."""

with tempfile.NamedTemporaryFile("w", suffix=".po", encoding="utf-8",

delete=False) as f:

f.write(text)

tmp = f.name

try:

po = polib.pofile(tmp)

return {e.msgid: ("" if "fuzzy" in e.flags else e.msgstr)

for e in po if not e.obsolete and e.msgid}

finally:

os.unlink(tmp)

def po_dateien(ref):

aus = git("ls-tree", "-r", "--name-only", ref) or ""

return {z for z in aus.split("\n") if z.endswith(".po")}

def main() -> None:

p = argparse.ArgumentParser(

description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)

p.add_argument("--von", required=True, metavar="BRANCH",

help="Quellbranch, aus dem uebertragen wird (z. B. 3.15)")

p.add_argument("--apply", action="store_true",

help="tatsaechlich schreiben (ohne dies nur ein Trockenlauf)")

p.add_argument("--leere-ziele", action="store_true", dest="leere_ziele",

help="auch Eintraege fuellen, die im Ziel leer sind, "

"obwohl sich die Quelle nicht bewegt hat")

p.add_argument("--nur", help="nur diese Pfadanfaenge, kommagetrennt")

p.add_argument("-o", "--ausgabe", metavar="DATEI",

help="Konfliktbericht als Markdown schreiben")

args = p.parse_args()

ziel = (git("rev-parse", "--abbrev-ref", "HEAD") or "").strip()

if not ziel:

sys.exit("Kein Git-Repository -- bitte im python-docs-de-Verzeichnis starten.")

if ziel == args.von:

sys.exit(f"Quelle und Ziel sind derselbe Branch ({ziel}).")

# Nur geaenderte .po-Dateien sind gefaehrlich: sie wuerden mit den

# uebertragenen Eintraegen vermischt. Unversionierte Dateien und

# geaenderte Skripte stoeren nicht.

schmutzig = [z[3:] for z in (git("status", "--porcelain", "--untracked-files=no")

or "").splitlines() if z[3:].endswith(".po")]

if schmutzig and args.apply:

sys.exit(f"{len(schmutzig)} .po-Datei(en) sind ungespeichert geaendert, "

f"z. B. {schmutzig[0]}.\nBitte erst committen oder stashen.")

vorfahr = (git("merge-base", ziel, args.von) or "").strip()

if not vorfahr:

sys.exit(f"Kein gemeinsamer Vorfahr von {ziel} und {args.von} gefunden.")

dateien = sorted(po_dateien(ziel) & po_dateien(args.von))

if args.nur:

anfaenge = tuple(a.strip() for a in args.nur.split(",") if a.strip())

dateien = [d for d in dateien if d.startswith(anfaenge)]

print(f"{ziel} <- {args.von} (Vorfahr {vorfahr[:8]}, {len(dateien)} Dateien)",

file=sys.stderr)

uebertragen, gefuellt, konflikte = [], [], []

for nr, pfad in enumerate(dateien, 1):

if nr % 100 == 0:

print(f" {nr}/{len(dateien)}", file=sys.stderr)

t_quelle = git("show", f"{args.von}:{pfad}")

if t_quelle is None or not os.path.isfile(pfad):

continue

quelle = karte(t_quelle)

t_basis = git("show", f"{vorfahr}:{pfad}")

basis = karte(t_basis) if t_basis else {}

po = polib.pofile(pfad, wrapwidth=79)

n = 0

for e in po:

if e.obsolete or not e.msgid or e.msgid not in quelle:

continue

hier = "" if "fuzzy" in e.flags else e.msgstr

dort = quelle[e.msgid]

if not dort or dort == hier:

continue

urzustand = basis.get(e.msgid, "")

hier_neu, dort_neu = hier != urzustand, dort != urzustand

if dort_neu and hier_neu:

konflikte.append((pfad, e.msgid, hier, dort))

continue

if not dort_neu and not (args.leere_ziele and not hier):

continue

if args.apply:

e.msgstr = dort

if "fuzzy" in e.flags:

e.flags.remove("fuzzy")

(gefuellt if not hier else uebertragen).append(pfad)

n += 1

if n and args.apply:

if po.metadata_is_fuzzy:

po.metadata_is_fuzzy = False

po.save(pfad)

kopf = "GESCHRIEBEN" if args.apply else "TROCKENLAUF"

print(f"\n{kopf}: {len(uebertragen)} aktualisiert, {len(gefuellt)} Luecken gefuellt, "

f"{len(konflikte)} Konflikte")

if not args.apply:

print("Mit --apply wird tatsaechlich geschrieben.")

if konflikte:

zeilen = [f"# Konflikte beim Abgleich {ziel} <- {args.von}\n",

"Beide Seiten haben sich seit dem gemeinsamen Vorfahren bewegt.",

"Diese Eintraege wurden NICHT angefasst.\n"]

aktuell = None

for pfad, mid, hier, dort in konflikte:

if pfad != aktuell:

zeilen.append(f"\n## {pfad}\n"); aktuell = pfad

zeilen.append(f"- msgid: `{mid[:100]}`")

zeilen.append(f" - {ziel}: {hier[:160]}")

zeilen.append(f" - {args.von}: {dort[:160]}")

bericht = "\n".join(zeilen)

if args.ausgabe:

open(args.ausgabe, "w", encoding="utf-8").write(bericht + "\n")

print(f"Konfliktbericht geschrieben: {args.ausgabe}", file=sys.stderr)

else:

print("\n" + bericht[:3000])

if args.apply:

print("\nJetzt noch: powrap -m und ./pre_push_check.sh --quick")

if __name__ == "__main__":

main()

python-docs-de/tools/sync_branches.py at sync-upstream-3.14 · python/python-docs-de · GitHub

Repository navigation

Expand file tree

Breadcrumbs

sync_branches.py

Latest commit

History

Breadcrumbs

sync_branches.py

File metadata and controls