hexagonal

name	hexagonal
description	Hexagonal architecture ports and adapters. Use for testable systems.

Hexagonal Architecture (Ports and Adapters)

Hexagonal Architecture aims to create a loosely coupled application component that can easily connect to their software environment by "ports" and "adapters". It treats the database, the web UI, and external APIs as interchangeable "details" (infrastructure).

When to Use

• When you need to support multiple input channels (e.g., REST API, GraphQL, CLI, Message Queue) for the same business logic.
• When you want to be able to swap "driven" actors (e.g., verify logic with a Mock DB, then swap to Postgres).
• Developing standard microservices.

Quick Start

// --- CORE (Inside the Hexagon) ---

// Port (Driver Port - Input)
type UserService interface {
    Register(name string) error
}

// Port (Driven Port - Output)
type UserRepository interface {
    Save(user User) error
}

// Application Service (Implementation)
type UserServiceImpl struct {
    repo UserRepository
}

func (s *UserServiceImpl) Register(name string) error {
    return s.repo.Save(User{Name: name})
}

// --- ADAPTERS (Outside the Hexagon) ---

// Driving Adapter (REST API)
 {
    svc.Register(r.FormValue())
}


 PostgresRepo  { db *sql.DB }
 Save(u User)  { ... }