Предсказуемый API
Сделайте ваши API предсказуемыми через соглашения об именовании и реализацию общих трейтов.
// Copyright 2025 Google LLC
// SPDX-License-Identifier: Apache-2.0
/* Какие трейты должен реализовывать этот тип? */
pub struct ApiToken(String);
impl ApiToken {
// Как должен называться этот метод?
pub unsafe fn ____(String) -> ApiToken;
}
This slide and its sub-slides should take about 107 minutes.
-
Предсказуемый API — такой, в котором пользователь может делать предположения о части API на основе поверхностных деталей, таких как имена, типы и сигнатуры.
-
Мы рассмотрим распространённые соглашения об именовании в Rust, которые позволяют пользователям быстро искать методы, подходящие для их задач, и быстро понимать существующий код.
-
Также мы рассмотрим общие трейты, которые реализуют типы, и когда стоит реализовывать их для ваших собственных типов.