Improve Linux terminal input and interactive path prompts

This commit is contained in:
ajp_anton committed 2026-10-06 19:27:26 +00:00
1 parent eb5937a629
commit ad2b15994f
5 files changed
+190 -22

No files matched your search

+95
View File
@@ -1,7 +1,102 @@
from __future__ import annotations
import glob
import os
from contextlib import contextmanager
from pathlib import Path
from urllib.parse import unquote, urlparse
from tools.console import prompt_input
def entered_path(value: str) -> Path:
text = value.strip()
if len(text) > 1 and text[0] == text[-1] and text[0] in "\"'":
text = text[1:-1]
if text.startswith("file://"):
text = unquote(urlparse(text).path)
return Path(text).expanduser()
def path_completions(text: str, base: Path | None = None) -> list[str]:
quote = text[0] if text[:1] in {"\"", "'"} else ""
value = text[1:] if quote else text
if quote and value.endswith(quote):
value = value[:-1]
expanded = os.path.expanduser(value)
relative = base is not None and not Path(expanded).is_absolute()
search = os.path.join(str(base), expanded) if relative else expanded
found = sorted(glob.glob(glob.escape(search) + "*"), key=str.casefold)
matches = [os.path.relpath(match, base) for match in found] if relative else found.copy()
if value.startswith("~"):
home = str(Path.home())
matches = ["~" + match[len(home):] if match.startswith(home) else match for match in matches]
return [
quote + match + (os.sep if Path(found[index]).is_dir() else "")
for index, match in enumerate(matches)
]
def complete_path(text: str, base: Path | None = None) -> str:
matches = path_completions(text, base)
return os.path.commonprefix(matches) if matches else text
@contextmanager
def path_completion(candidates=path_completions):
try:
import readline
except ImportError:
yield
return
previous = readline.get_completer(), readline.get_completer_delims()
matches: list[str] = []
def complete(text: str, state: int) -> str | None:
nonlocal matches
if state == 0:
matches = candidates(text)
return matches[state] if state < len(matches) else None
readline.set_completer(complete)
readline.set_completer_delims("\n")
readline.parse_and_bind("tab: complete")
try:
yield
finally:
readline.set_completer(previous[0])
readline.set_completer_delims(previous[1])
def prompt_existing_paths() -> list[str]:
print("Enter one file or directory per line. Leave the path empty when finished.")
paths: list[str] = []
with path_completion():
while True:
value = prompt_input("Path: ").strip()
if not value:
return paths
path = entered_path(value)
if not path.exists():
print("Path not found. Try again.")
continue
paths.append(str(path.resolve()))
def input_paths(argv: list[str]) -> list[str]:
return argv[1:] or prompt_existing_paths()
def resolve_output_directory(value: str, default: Path) -> Path:
if not value.strip():
return default
path = entered_path(value)
path = path if path.is_absolute() else default / path
path = path.resolve()
if path.exists() and not path.is_dir():
raise ValueError("The output path exists but is not a directory.")
return path
def existing_input_paths(args: list[str], *, print_missing: bool = False) -> list[Path]: