Skip to content

scripts/set-alias-page.py: add inexact matching for alias finding #19993

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Managor merged 3 commits into from
Dec 15, 2025
Merged

scripts/set-alias-page.py: add inexact matching for alias finding #19993

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
9dbde7c
inexact alias matching
Managor Dec 14, 2025
cbcb584
reduce nesting
Managor Dec 14, 2025
a8d028b
Update set-alias-page.py
Managor Dec 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 24 additions & 12 deletions scripts/set-alias-page.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@
Stage modified pages (requires 'git' on $PATH and TLDR_ROOT to be a Git repository).
-n, --dry-run
Show what changes would be made without actually modifying the page.
-i, --inexact
Ignore direct template matching to find non-standard alias pages.

Examples:
1. Create a new alias page interactively:
Expand Down Expand Up @@ -80,6 +82,7 @@ class Config:
templates: dict[str, str]
dry_run: bool = False
language: str = ""
inexact: bool = False


@dataclass
Expand Down Expand Up @@ -269,19 +272,20 @@ def get_alias_command_in_page(path: Path, alias_pattern: str) -> AliasPageConten
if len(command_lines) != 2 or not title:
return AliasPageContent(title="", original_command="", documentation_command="")

if alias_pattern == get_locale_alias_pattern("en"):
stripped_template = config.templates["en"]
stripped_template = stripped_template.replace("example", "")
if not config.inexact:
if alias_pattern == get_locale_alias_pattern("en"):
stripped_template = config.templates["en"]
stripped_template = stripped_template.replace("example", "")

stripped_en = content
stripped_en = re.sub(r"#.*", "# ", stripped_en)
stripped_en = re.sub(r"`(?!tldr).*`", "``", stripped_en)
stripped_en = re.sub(r"`tldr .*`", "`tldr `", stripped_en)
stripped_en = content
stripped_en = re.sub(r"#.*", "# ", stripped_en)
stripped_en = re.sub(r"`(?!tldr).*`", "``", stripped_en)
stripped_en = re.sub(r"`tldr .*`", "`tldr `", stripped_en)

if stripped_template != stripped_en:
return AliasPageContent(
title="", original_command="", documentation_command=""
)
if stripped_template != stripped_en:
return AliasPageContent(
title="", original_command="", documentation_command=""
)

original_command = ""
documentation_command = ""
Expand Down Expand Up @@ -468,6 +472,14 @@ def main():
parser = create_argument_parser(
"Sets the alias page for all translations of a page"
)
parser.add_argument(
"-i",
"--inexact",
action="store_true",
default=False,
help="Do not match precisely with the alias template",
)

args = parser.parse_args()

# Print usage information if no arguments were provided
Expand All @@ -486,8 +498,8 @@ def main():
templates=templates,
dry_run=args.dry_run,
language=args.language,
inexact=args.inexact,
)

target_paths = []

# Use '--page' option
Expand Down
Loading