fieldwork 0.5.1

derivable accessors for struct fields
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
63
64
65
66
67
68
69
70
71
72

# `without` — negative owned setters

The `without` method generates owned setters that represent the "negative" state of a field.
It is designed to be used alongside [`with`](crate::with) and changes how `with` works for
`bool` and `Option` fields:

- **`bool` fields**: `with_field()` sets to `true`, `without_field()` sets to `false`
- **`Option<T>` fields**: `with_field(value)` sets to `Some(value)`, `without_field()` sets to `None`
- **Other fields**: `without` methods are not generated; `with` works normally

```rust
#[derive(fieldwork::Fieldwork)]
#[fieldwork(with, without)]
struct Config {
    /// whether debug mode is on
    debug: bool,

    /// optional log file path
    log_file: Option<String>,

    /// application name (no without generated)
    name: String,
}
```

```rust
// GENERATED
# struct Config { debug: bool, log_file: Option<String>, name: String, }
impl Config {
    ///Owned chainable setter for whether debug mode is on, returning `Self`
    #[must_use]
    pub fn with_debug(mut self) -> Self {
        self.debug = true;
        self
    }
    ///Owned chainable setter for whether debug mode is on, returning `Self`
    #[must_use]
    pub fn without_debug(mut self) -> Self {
        self.debug = false;
        self
    }
    ///Owned chainable setter for optional log file path, returning `Self`
    #[must_use]
    pub fn with_log_file(mut self, log_file: String) -> Self {
        self.log_file = Some(log_file);
        self
    }
    ///Owned chainable setter for optional log file path, returning `Self`
    #[must_use]
    pub fn without_log_file(mut self) -> Self {
        self.log_file = None;
        self
    }
    ///Owned chainable setter for application name (no without generated), returning `Self`
    #[must_use]
    pub fn with_name(mut self, name: String) -> Self {
        self.name = name;
        self
    }
}

```

## Enums

On enums, `without` is only generated for full-coverage `bool` and `Option<T>`
fields. See [`enums`](crate::enums).

## Skipping `without` for a field

Use `#[field(without = false)]` or `#[field(without(skip))]` to suppress the `without` method
for a specific field while keeping it enabled item-wide.