hexser 0.5.0

Zero-boilerplate hexagonal architecture with graph-based introspection
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! Dependency injection container example.
//!
//! Demonstrates zero-boilerplate service management with the hex
//! container. Shows registration of services with different scopes,
//! resolution with dependency injection, and proper error handling.
//!
//! Run with: cargo run --example container_example --features container

#[cfg(feature = "container")]
#[tokio::main]
async fn main() -> hexser::HexResult<()> {
  println!("=== Dependency Injection Container Example ===\n");

  let container = hexser::container::Container::new();

  println!("1. Registering services...");

  let config_provider = ConfigProvider {
    api_key: String::from("secret-key-123"),
  };
  container
    .register(
      "config",
      config_provider,
      hexser::container::Scope::Singleton,
    )
    .await?;
  println!("   ✓ Config service registered (Singleton)");

  let email_provider = EmailProvider {
    host: String::from("smtp.example.com"),
  };
  container
    .register("email", email_provider, hexser::container::Scope::Transient)
    .await?;
  println!("   ✓ Email service registered (Transient)");

  println!("\n2. Resolving services...");

  let config = container.resolve::<ConfigService>("config").await?;
  println!("   ✓ Config resolved: API Key = {}", config.api_key);

  let email1 = container.resolve::<EmailService>("email").await?;
  let email2 = container.resolve::<EmailService>("email").await?;
  println!("   ✓ Email service resolved twice (Transient scope)");
  println!("     - Instance 1: {}", email1.host);
  println!("     - Instance 2: {}", email2.host);

  println!("\n3. Container info:");
  println!(
    "   Total services registered: {}",
    container.service_count().await
  );
  println!(
    "   Contains 'config': {}",
    container.contains("config").await
  );
  println!("   Contains 'email': {}", container.contains("email").await);

  println!("\n4. Cloning container (shares registrations)...");
  let container2 = container.clone();
  println!(
    "   ✓ Cloned container service count: {}",
    container2.service_count().await
  );

  let config2 = container2.resolve::<ConfigService>("config").await?;
  println!("   ✓ Resolved from cloned container: {}", config2.api_key);

  println!("\n✅ Container example completed!");

  Ok(())
}

#[cfg(not(feature = "container"))]
fn main() {
  println!("This example requires the 'container' feature.");
  println!("Run with: cargo run --example container_example --features container");
}

#[cfg(feature = "container")]
struct ConfigService {
  api_key: String,
}

#[cfg(feature = "container")]
struct ConfigProvider {
  api_key: String,
}

#[cfg(feature = "container")]
impl hexser::container::Provider<ConfigService> for ConfigProvider {
  fn provide(&self) -> hexser::HexResult<ConfigService> {
    Ok(ConfigService {
      api_key: self.api_key.clone(),
    })
  }
}

#[cfg(feature = "container")]
struct EmailService {
  host: String,
}

#[cfg(feature = "container")]
struct EmailProvider {
  host: String,
}

#[cfg(feature = "container")]
impl hexser::container::Provider<EmailService> for EmailProvider {
  fn provide(&self) -> hexser::HexResult<EmailService> {
    Ok(EmailService {
      host: self.host.clone(),
    })
  }
}