Упражнение: Реорганизация графической библиотеки
В этом упражнении вы реорганизуете небольшую реализацию библиотеки для GUI. Эта библиотека определяет трейт Widget, несколько его реализаций и функцию main.
Обычно каждый тип или набор тесно связанных типов помещают в собственный модуль, поэтому каждый тип виджета должен получить свой модуль.
Настройка Cargo
Playground Rust поддерживает только один файл, поэтому вам понадобится создать проект Cargo на локальной файловой системе:
cargo init gui-modules
cd gui-modules
cargo run
Отредактируйте полученный src/main.rs, добавив операторы mod, и создайте дополнительные файлы в каталоге src.
Исходный код
Вот реализация библиотеки GUI в одном модуле:
// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
pub trait Widget {
/// Естественная ширина `self`.
fn width(&self) -> usize;
/// Отрисовать виджет в буфер.
fn draw_into(&self, buffer: &mut dyn std::fmt::Write);
/// Отрисовать виджет в стандартный вывод.
fn draw(&self) {
let mut buffer = String::new();
self.draw_into(&mut buffer);
println!("{buffer}");
}
}
pub struct Label {
label: String,
}
impl Label {
fn new(label: &str) -> Label {
Label { label: label.to_owned() }
}
}
pub struct Button {
label: Label,
}
impl Button {
fn new(label: &str) -> Button {
Button { label: Label::new(label) }
}
}
pub struct Window {
title: String,
widgets: Vec<Box<dyn Widget>>,
}
impl Window {
fn new(title: &str) -> Window {
Window { title: title.to_owned(), widgets: Vec::new() }
}
fn add_widget(&mut self, widget: Box<dyn Widget>) {
self.widgets.push(widget);
}
fn inner_width(&self) -> usize {
std::cmp::max(
self.title.chars().count(),
self.widgets.iter().map(|w| w.width()).max().unwrap_or(0),
)
}
}
impl Widget for Window {
fn width(&self) -> usize {
// Добавить 4 отступа для рамок
self.inner_width() + 4
}
fn draw_into(&self, buffer: &mut dyn std::fmt::Write) {
let mut inner = String::new();
for widget in &self.widgets {
widget.draw_into(&mut inner);
}
let inner_width = self.inner_width();
// TODO: Измените draw_into, чтобы он возвращал Result<(), std::fmt::Error>. Затем используйте
// оператор ? здесь вместо .unwrap().
writeln!(buffer, "+-{:-<inner_width$}-+", "").unwrap();
writeln!(buffer, "| {:^inner_width$} |", self.title).unwrap();
writeln!(buffer, "+={:=<inner_width$}=+", "").unwrap();
for line in inner.lines() {
writeln!(buffer, "| {:inner_width$} |", line).unwrap();
}
writeln!(buffer, "+-{:-<inner_width$}-+", "").unwrap();
}
}
impl Widget for Button {
fn width(&self) -> usize {
self.label.width() + 8 // добавим немного отступов
}
fn draw_into(&self, buffer: &mut dyn std::fmt::Write) {
let width = self.width();
let mut label = String::new();
self.label.draw_into(&mut label);
writeln!(buffer, "+{:-<width$}+", "").unwrap();
for line in label.lines() {
writeln!(buffer, "|{:^width$}|", line).unwrap();
}
writeln!(buffer, "+{:-<width$}+", "").unwrap();
}
}
impl Widget for Label {
fn width(&self) -> usize {
self.label.lines().map(|line| line.chars().count()).max().unwrap_or(0)
}
fn draw_into(&self, buffer: &mut dyn std::fmt::Write) {
writeln!(buffer, "{}", self.label).unwrap();
}
}
fn main() {
let mut window = Window::new("Rust GUI Demo 1.23");
window.add_widget(Box::new(Label::new("This is a small text GUI demo.")));
window.add_widget(Box::new(Button::new("Click me!")));
window.draw();
}
Поощряйте студентов разделить код так, как им кажется естественным, и привыкнуть к необходимым объявлениям mod, use и pub. После этого обсудите, какая организация наиболее идиоматична.