AOC: переиспользуем код в Rust
После первой задачки Advent of Code у меня нашлась функция, которую стоит переиспользовать:
use std::fs::File;
use std::io::prelude::*;
// TODO: Share between puzzles...
fn read_puzzle_input(number: u8) -> String {
let mut input =
File::open(format!("./inputs/{}.txt", number))
.expect("Puzzle input not found...");
let mut text = String::new();
input
.read_to_string(&mut text)
.expect("cannot read input file");
return text;
}
Хочу вынести её в отдельный файл и как-нибудь переиспользовать во всех своих решениях. Быстрый гуглёж приводит к главе «Using Modules to Reuse and Organize Code» из The Rust Book.
Что делать, если функций становится слишком много? В Rust есть система модулей, которая позволяет переиспользовать код, не теряя порядка.
Отлично! Две важные вещи прямо с первой страницы:
- По умолчанию функции, типы, константы и модули приватны. Ключевое слово
pubделает элемент публичным, а значит, видимым за пределами его пространства имён. - Ключевое слово
useвводит в область видимости модули или определения внутри модулей, чтобы на них было проще ссылаться.
Модули в Rust можно раскладывать довольно гибко, и для их организации есть свои правила. В моём простом случае хватило нескольких шагов:
- Перенёс функцию в отдельный файл `src/utils.rs`
- добавил перед функцией ключевое слово pub: pub fn read_puzzle_input...
- и дописал небольшой кусочек в Cargo.toml:
[lib]
name = "utils"
path = "src/utils.rs"
Теперь, чтобы пользоваться функциями из этой библиотеки, нужно добавить в начало файла объявление крейта и вызывать функцию через пространство имён utils:
extern crate utils;
fn part_one() {
let input = utils::read_puzzle_input(1);
let mut result: i32 = 0;
for line in input.lines() {
let num = line.parse::<i32>().unwrap();
result += num;
}
println!("Sum of freq adjustments: {}", result);
}
Код.