former 2.43.0

A flexible implementation of the Builder pattern supporting nested builders and collection-specific subformers. Simplify the construction of complex objects.
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

#![ allow( dead_code ) ]

//! This test reproduces the ACTUAL problem from `task/improve_former_derive_user_experience.md`
//!
//! ## The Real Issue
//!
//! When users import `Former` directly from `former_meta` (bypassing the re-exports),
//! they get 90+ cryptic errors because trait dependencies from `former_types` are not in scope.
//!
//! ## This test SHOULD FAIL with errors like:
//! ```
//! error[E0220]: associated type `Storage` not found for `Definition`
//! error[E0220]: associated type `Context` not found for `Definition`
//! error[E0433]: failed to resolve: could not find `FormingEnd` in `former`
//! error[E0433]: failed to resolve: could not find `StoragePreform` in `former`
//! ```

// WRONG IMPORT PATTERN - bypasses the helpful re-exports
use former_meta::Former;

/// Test configuration struct demonstrating broken import pattern.
///
/// This will FAIL to compile because `FormingEnd`, `StoragePreform`, etc. are not in scope.
#[ derive( Debug, PartialEq, Former ) ]
pub struct BrokenConfig
{
  host : String,
  port : u16,
}

#[ test ]
fn test_broken_usage()
{
  // This code is unreachable because the struct definition above fails to compile
  let _config = BrokenConfig::former()
    .host( "localhost".to_string() )
    .port( 8080_u16 )
    .form();
}