if_empty 0.1.0

Replace `if foo.is_empty() { Foo { ... } } else { foo }` with a simple `foo.if_empty(Foo { ... })`
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# IfEmpty

[![CI Status](https://github.com/cschlosser/ifempty/actions/workflows/ci.yml/badge.svg)](https://github.com/cschlosser/IfEmpty/actions/workflows/ci.yml)

A crate to use for defensive programming where context specific defaults are needed.

## Motivation

While using an `Option` is preferrably in most circumstances there are situations where a function call
doesn't return a `Option` and the `Default` of a type isn't helpful either.

You now have the option to wrap this special function call or write something along these lines:

```rust
let foo = {
    let b = bar();
    if b.is_empty() {
        Bar {
            // set the default values for your context here
        }
    } else {
        b
    }
};
```

Using this crate you can reduce this down to:

```rust
let foo = bar().if_empty(Bar { /* ... */ });
```

## Implementing this for your own type

In order to take advantage of this feature you have to implement this behavior for your types:

```rust

use if_empty::*;

struct Foo {
    val: bool,
}

impl IfEmpty for Foo {
    fn if_empty(self, value: Foo) -> Foo {
        if self.is_empty() {
            value
        } else {
            self
        }
    }
}

```

Once [#1](https://github.com/cschlosser/IfEmpty/issues/1) is implemented you can simply use `derive`.

## Provided types

The crate provides this functionality for `String` and `&str`.