license_display.py

Go to the documentation of this file.

# Copyright (c) 2025-present Aquin Labs Private Limited. All Rights Reserved.
"""ASCII terminal layout for the AQIT license."""
 
from __future__ import annotations
 
import sys
 
from aquin.ascii_layout import (
    BANNER,
    ascii_safe,
    box_bottom,
    box_line,
    box_lines,
    box_top,
    center,
    center_block,
    print_banner,
    rule,
    width,
)
from aquin.license_text import LICENSE_URL, read_license_text
 
# Compatibility aliases for callers that import private helpers from this module.
_BANNER = BANNER
_width = width
_rule = rule
_center = center
_center_block = center_block
_box_line = box_line
_box_lines = box_lines
_box_top = box_top
_box_bottom = box_bottom
_ascii_safe = ascii_safe
 
 
def render_license_document(
    *,
    context: str = "view",
    show_acceptance_footer: bool = False,
) -> None:
    """Print the full license in a consistent ASCII frame."""
    w = width()
    license_text = ascii_safe(read_license_text().rstrip())
 
    print_banner(subtitle="ENGINE | PROPRIETARY SOFTWARE LICENSE", w=w)
    print(center(f"canonical: {LICENSE_URL}", w))
    print()
 
    if context == "login":
        print(box_top(w))
        print(box_line("LOGGED IN - review the license below, then accept at the end", w))
        print(box_bottom(w))
        print()
    elif context == "first_use":
        print(box_top(w))
        print(box_line("REVIEW REQUIRED - accept at the end to continue", w))
        print(box_bottom(w))
        print()
 
    print(box_top(w))
    for line in license_text.splitlines():
        for boxed in box_lines(line, w):
            print(boxed)
    print(box_bottom(w))
    print()
 
    if show_acceptance_footer:
        print(rule("=", w))
        print(center("ACCEPTANCE", w))
        print(rule("-", w))
        print()
        print("  You must accept this license to use Aquin.")
        print()
        print("    y / yes     accept and continue")
        print("    n / no      decline")
        print()
        print(rule("=", w))
 
 
def prompt_license_acceptance(*, context: str = "first_use") -> bool:
    """Show the full license and ask the user to accept."""
    if not sys.stdin.isatty():
        return False
 
    render_license_document(context=context, show_acceptance_footer=True)
 
    try:
        answer = input("  accept? (y/n): ").strip().lower()
    except (EOFError, KeyboardInterrupt):
        print()
        return False
 
    return answer in {"y", "yes"}