Helpers for Advent of Code
This crate contains some helper methods that I regularly use in my Advent of Code solutions.
Processing of command line arguments
args::get_args
Reads the command line arguments and checks whether the correct number of arguments are present.
Example
use get_args;
Error handling
error::WithOrExit
This trait adds a or_exit_with
method.
The purpose of this method, is to allow you to easily let your program terminate with a specific exit code.
It has been implemented for Result and Option.
The implementation for Result requires that the associated error type implements fmt::Debug.
Example
use WithOrExit;
error::ParseError
A generic error containing just a message. It implements fmt::Display and fmt::Debug, and it can be converted from io::Error and num::ParseIntError.
Example
use ParseError;
I/O operations
input::MultilineFromStr
This trait is inspired by the str::FromStr trait, and allows you to parse input where data might span several lines.
Example
use ParseError;
use MultilineFromStr;
input::WithReadLines
This trait adds a read_lines
method.
The purpose of this method is to read the lines from some source (e.g. a file), and then convert each line to a specific type.
As an argument, this method takes an exit code that should be used if processing the source fails, and it returns an iterator.
This trait has been implemented for fs::File.
Example
use WithReadLines;
input::WithReadMultiLines
This trait adds a read_multi_lines
method.
It's the equivalent of input::WithReadLines
, but rather than depending on str::FromStr, it depends on input::MultilineFromStr
.
Example
use WithReadMultiLines;
input::WithAsRecords
& input::WithAsMultilineRecords
These traits allow you to easily convert an object to a vec of items of the required type.
Example
Parts
part::Part
This enum is useful if you need to explicitly refer to a part. It implemts str::FromStr and fmt::Display, so you can easily convert to and from a string.
Example
use Part;