#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

#1363 in Rust patterns

Download history 5/week @ 2024-07-27 37/week @ 2024-08-17 34/week @ 2024-08-24 58/week @ 2024-08-31 31/week @ 2024-09-07 66/week @ 2024-09-14 64/week @ 2024-09-21 102/week @ 2024-09-28 71/week @ 2024-10-05 81/week @ 2024-10-12 87/week @ 2024-10-19 53/week @ 2024-10-26 50/week @ 2024-11-02 46/week @ 2024-11-09

273 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