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

//! Tutorial 02: Adding Ports
//!
//! Demonstrates how to define port interfaces that separate
//! domain logic from infrastructure concerns.
//!
//! Run with: cargo run --example tutorial_02_ports

use hexser::prelude::*;

// Domain Layer - from Tutorial 01
#[derive(HexDomain, HexEntity)]
struct Todo {
  id: String,
  title: String,
  done: bool,
}

// Port Layer - NEW!
#[derive(HexPort, HexRepository)]
struct TodoRepository;

fn main() {
  println!("🎓 Tutorial 02: Adding Ports\n");
  println!("{}", "=".repeat(50));

  let graph = HexGraph::current();

  println!("\n✅ Both domain and port layers registered!");
  graph.pretty_print();

  println!("\n📊 Architecture layers:");
  println!(
    "  Domain: {} components",
    graph.nodes_by_layer(Layer::Domain).len()
  );
  println!(
    "  Ports: {} components",
    graph.nodes_by_layer(Layer::Port).len()
  );

  println!("\n💡 Key concept:");
  println!("  Ports define WHAT your application needs");
  println!("  Adapters (next tutorial) define HOW it works");

  println!("\n🎉 You've separated domain from infrastructure!");
  println!("{}", "=".repeat(50));

  println!("\nNext: Try Tutorial 03 - Implementing Adapters");
  println!("  cargo run --example tutorial_03_adapters");
}