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

//! Tutorial 01: Your First Entity
//!
//! Learn to create domain entities - the foundation of hexagonal architecture.
//! Time: 5 minutes
//!
//! Run with: `cargo run --example tutorial_01_entity`

fn main() -> hexser::HexResult<()> {
  println!("=== Tutorial 01: Your First Entity ===\n");

  // Step 1: Define a domain entity
  // Entities have identity and represent core business concepts
  #[derive(Clone, Debug)]
  struct User {
    id: String,
    email: String,
    name: String,
  }

  // Step 2: Implement the HexEntity trait
  // This gives your type hexagonal architecture superpowers!
  impl hexser::domain::HexEntity for User {
    type Id = String; // Define what uniquely identifies this entity
  }

  // Step 3: Create and use your entity
  let user = User {
    id: String::from("user_001"),
    email: String::from("alice@example.com"),
    name: String::from("Alice"),
  };

  println!("✅ Created entity:");
  println!("   ID: {}", user.id);
  println!("   Name: {}", user.name);
  println!("   Email: {}", user.email);

  // Step 4: Understand what you've built
  println!("\n📚 What you learned:");
  println!("   - Domain entities represent business concepts");
  println!("   - Entities have unique identity (ID)");
  println!("   - Entities live in the Domain layer (no dependencies!)");

  println!("\n🎯 Key Concepts:");
  println!("   ┌─────────────┐");
  println!("   │   Domain    │  ← Your User entity lives here");
  println!("   │   [User]    │  ← Pure business logic, no tech dependencies");
  println!("   └─────────────┘");

  println!("\n✅ Tutorial 01 Complete!");
  println!("Next: `cargo run --example tutorial_02_repository`");

  Ok(())
}