python-docs-fa/scripts/generate_status_table.py at 3.15 · python/python-docs-fa · 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

#!/usr/bin/env python3

"""

scripts/generate_status_table.py

Regenerate the per-file translation status table between marker comments in

a markdown file (default: STATUS.md) from the current state of all .po

files. Meant to run on a schedule so the table never goes stale, replacing

the old Transifex-exported report.

The file is only rewritten when the table itself changes. The date line is

not refreshed on its own, so a scheduled run with no real changes leaves the

file (and git history) untouched.

Requires: pip install polib

Usage:

python3 scripts/generate_status_table.py

python3 scripts/generate_status_table.py --file STATUS.md

"""

import argparse

import re

import sys

from datetime import date

from pathlib import Path

import polib

REPO_ROOT = Path(__file__).resolve().parent.parent

START_MARKER = ""

END_MARKER = ""

def file_stats(path: Path):

po = polib.pofile(str(path))

return (

len(po.translated_entries()),

len(po.fuzzy_entries()),

len(po.untranslated_entries()),

)

def build_table() -> str:

files = sorted(REPO_ROOT.rglob("*.po"))

rows = []

totals = {"translated": 0, "fuzzy": 0, "untranslated": 0}

for f in files:

if ".cpython-src" in f.parts or ".git" in f.parts:

continue

t, fz, u = file_stats(f)

total = t + fz + u

translated_pct = (t / total * 100) if total else 100.0

fuzzy_pct = (fz / total * 100) if total else 0.0

rel = f.relative_to(REPO_ROOT)

rows.append((str(rel), translated_pct, fuzzy_pct, t, u, total))

totals["translated"] += t

totals["fuzzy"] += fz

totals["untranslated"] += u

# most-complete files first, matching the old report's ordering

rows.sort(key=lambda r: (-r[1], r[0]))

lines = [

"|:-----|:-----------:|:-----------:|:-----------:|:-----------:|",

]

for name, t_pct, f_pct, t_count, u_count, _total in rows:

lines.append(

f"| {name} | {t_pct:.1f}% | {f_pct:.1f}% | {t_count} | {u_count} |"

)

grand_total = sum(totals.values())

lines.append(

f"| **مجموع** | "

f"**{(totals['translated'] / grand_total * 100) if grand_total else 100.0:.1f}%** | "

f"**{(totals['fuzzy'] / grand_total * 100) if grand_total else 0.0:.1f}%** | "

f"**{totals['translated']}** | **{totals['untranslated']}** |"

)

return "\n".join(lines)

def main():

parser = argparse.ArgumentParser(description=__doc__)

parser.add_argument(

"--file",

default="STATUS.md",

help="Markdown file containing the marker block to update",

)

args = parser.parse_args()

target = REPO_ROOT / args.file

text = target.read_text(encoding="utf-8")

if START_MARKER not in text or END_MARKER not in text:

print(f"Markers {START_MARKER} / {END_MARKER} not found in {args.file}.")

print("Add them around the table you want auto-generated, then re-run.")

sys.exit(1)

table = build_table()

# If the freshly built table is already in the block, nothing but the date

# would change -- skip the write so we don't create a commit every night.

current_block = text[text.index(START_MARKER) : text.index(END_MARKER)]

if table in current_block:

print(f"{args.file} already up to date (table unchanged).")

return

block = (

f"{START_MARKER}\n"

f"### وضعیت ترجمه فایل‌ها\n"

f"(به‌روزرسانی: {date.today().isoformat()})\n\n"

f"{table}\n"

f"{END_MARKER}"

)

new_text = re.sub(

re.escape(START_MARKER) + r".*?" + re.escape(END_MARKER),

lambda _: block, # avoid backslash-escape surprises from re.sub

text,

flags=re.DOTALL,

)

target.write_text(new_text, encoding="utf-8")

print(f"Updated {args.file}.")

if __name__ == "__main__":

main()

python-docs-fa/scripts/generate_status_table.py at 3.15 · python/python-docs-fa · GitHub

Repository navigation

Expand file tree

Breadcrumbs

generate_status_table.py

Latest commit

History

Breadcrumbs

generate_status_table.py

File metadata and controls