#chaining #pipe #pipeline #tap

no-std tailsome

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

2 releases (1 stable)

1.0.0 Mar 16, 2023
0.1.0 Jan 21, 2022

#1007 in Rust patterns

Download history 3/week @ 2024-02-16 17/week @ 2024-02-23 11/week @ 2024-03-01 7/week @ 2024-03-08 43/week @ 2024-03-15 72/week @ 2024-03-22

134 downloads per month

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