#chaining #pipelines #tap #pipe

no-std tailsome

Blanket traits providing .into_ok(), .into_err(), and .into_some() for happier method chaining

1 unstable release

Uses new Rust 2021

0.1.0 Jan 21, 2022

#565 in Rust patterns

MIT/Apache

5KB

tailsome

Blanket traits providing methods for turning anything into an Option or Result.

Inspired by tap::Pipe, which provides a pipe method that allows the user to call any bare function in the middle of a method chain.

The most useful of these traits' methods is probably IntoResult::into_ok. Instead of wrapping a long method-chain expression in a call to Ok, try tacking an .into_ok() at the end. This can be especially pleasing in functions that return a Result and make judicious use of method chains and the ? operator.

use tailsome::IntoResult;

build_pipeline().unwrap();

fn build_pipeline() -> Result<Example, Error> {
    Builder::new()
        .set_option(42)
        .try_set_option("some flag")?
        .set_option("another option")
        .build()
        .into_ok()
}

struct Example;

struct Builder;
impl Builder {
    fn new() -> Self { Self }
    fn set_option<T>(self, t: T) -> Self { self }
    fn try_set_option<T>(self, t: T) -> Result<Self, Error> { Ok(self) }
    fn build(self) -> Example { Example }
}

#[derive(Debug)]
struct Error;

No runtime deps