Skip to content

Секреты: тип Secret[T] вместо масок по именам #609

Open

Description

@bim-ba

Ты спросил 19.11: «а мы разве не будем делать отдельную аннотацию Secret[...] для любых типов данных?» И сказал, что не хочешь масок по именам полей. Обе мысли сходятся в одно решение.

Вопрос

Секрет - это только тип Secret[T] для любого T, а все без этого типа печатается как есть?

Пример

# сейчас: только строки, и отдельный список имен в трех местах
password: SecretStr
access_token: str            # печатается в repr

# рекомендую
password: Secret[str]
access_token: Secret[str]
private_key: Secret[bytes]
headers: dict[str, Secret[str]]

ycli --dry-run api -F password=x выведет x. Поле без типа - это обычное значение, и ядро не угадывает его по имени.

вариант что это что ломается
А Secret[T] в ядре каждого языка, маска только по типу ycli api -F password= печатает пароль, как и сейчас
Б SecretStr как сейчас, плюс список имен твое «не маскировать по именам»

Рекомендую: А. Это продолжение твоего ответа в #579 («секретность определяется типом»), и понятие ядра при этом одинаково во всех языках.
Против: человек, который печатает пароль через -F, увидит его в плане --dry-run. Предупреждение в --help придется оставить.

Тип TokenResponse.access_token меняю на SecretStr отдельным PR. При ответе «А» он станет Secret[str].

Ответ одной строкой: «А» или «Б».

Activity

  1. added
    scope:coreHTTP core, transport, auth, settings
    needs:decisionWaiting for an owner decision
    wayfinder:grillingWayfinder ticket: a decision settled in conversation with the owner
    on Nov 18, 2026
  2. bim-ba commented on Nov 19, 2026

    @bim-ba
    OwnerAuthor

    рекомендация

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs:decisionWaiting for an owner decisionpriority:nowDo nowscope:coreHTTP core, transport, auth, settingswayfinder:grillingWayfinder ticket: a decision settled in conversation with the owner

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions