algoux-standard-ranklist-utils

Python utilities for Standard Ranklist (srk).

Supported srk versions: >=0.3.0 <0.4.0.

Install

pip install algoux-standard-ranklist-utils

Usage Sample

from standard_ranklist_utils import diagnose_ranklist, format_time_duration, patch_ranklist, resolve_text, sort_rows

format_time_duration([1.5, "h"], "min")  # 90
resolve_text({"fallback": "English", "zh-CN": "中文"}, ["zh-CN"])  # 中文
sort_rows(ranklist["rows"], ranklist.get("sorter", {}).get("config"))
diagnostics = diagnose_ranklist(ranklist)
patched = patch_ranklist(ranklist, {"type": "srk-patch", "version": 1, "operations": []})

Utilities

formatters

• format_time_duration: Convert an srk TimeDuration between ms, s, min, h, and d.
• pre_zero_fill: Left-pad a number with zeroes for fixed-width display.
• sec_to_time_str: Format elapsed seconds as a ranklist time string such as 1:02:03 or 1D 1:02:03.
• number_to_alphabet: Convert a zero-based problem index to an alphabetic alias such as A, Z, or AA.
• alphabet_to_number: Convert an alphabetic problem alias back to a zero-based index.

resolvers

• resolve_text: Resolve plain or i18n srk text using explicit language preferences and fallback text.
• resolve_contributor: Parse a contributor string into name, optional email, and optional url.
• resolve_color: Normalize an srk color value to a CSS color string.
• resolve_theme_color: Expand a single color or theme color object into explicit light and dark colors.
• resolve_style: Resolve text/background style colors and auto-pick readable text color when needed.
• resolve_user_markers: Resolve a user's marker IDs to marker definitions from the ranklist config.

ranklist

• sort_rows: Sort rows by ICPC solved count descending and penalty time ascending, with optional ranking-time precision.
• regenerate_ranklist_by_solutions: Rebuild rows, scores, sorting, and problem statistics from solution tetrads.
• regenerate_rows_by_incremental_solutions: Apply incremental solution tetrads to existing rows and re-sort them.
• convert_to_static_ranklist: Add precomputed per-series rank values and segment indexes to each row.

CCPC26 display layout

• get_ccpc26_problem_layout(ranklist): Compute the revealed/hidden original problem indexes from a complete current SRK 0.3.14 CCPC26 snapshot. Returns None without the standard ICPC CCPC26 configuration.
• get_ccpc26_row_problem_order(statuses, layout): Return the revealed prefix followed by hidden accepted, attempted, and untouched problems, using accepted/latest-submission times and stable original-index ties.
• CCPC26ProblemLayout: Exported TypedDict with revealedProblemIndexes and hiddenProblemIndexes lists.

from standard_ranklist_utils import get_ccpc26_problem_layout, get_ccpc26_row_problem_order

layout = get_ccpc26_problem_layout(ranklist)
if layout is not None:
    for row in ranklist["rows"]:
        indexes = get_ccpc26_row_problem_order(row["statuses"], layout)
        # Use these original indexes to render each row without rearranging its data.

The helpers are pure: they neither mutate the input nor retain reveal history. The application controls whether CCPC26 is active and when freeze timing restores ordinary display; compute the layout before filtering rows for display. Count and ratio thresholds use OR, have no implicit 50/0.2 defaults, and honor official-only, denominator and rounding options. An empty threshold object reveals nothing; a configured zero threshold is applied literally. See the cross-language display contract for time precedence and missing-time behavior.

diagnostics and patch

• diagnose_ranklist: Inspect SRK completeness/correctness and return structured issues plus repair suggestions.
• patch_ranklist: Apply a pure srk-patch object to a deep-copied ranklist.
• create_ranklist_patch_from_diagnostics: Convert diagnostic suggestions into an applicable srk-patch.