README
¶
Server Applications
The apps package contains app implementations that process HTTP requests.
Purpose
This package provides:
- App implementations (Echo, Script, MCP)
- App interface definition
- Map-based app storage by ID
Key Files
- app.go: App interface definition
- instances.go: Map wrapper for storing app instances by ID
- {type}/config.go: Configuration structs for each app type
- {type}/{type}.go: App implementation
App Interface
All apps implement two methods:
String()- Returns app IDHandleHTTP()- Processes HTTP requests
Data Flow: Static data is embedded during app creation, not passed at runtime.
App Types
Currently implemented:
- Echo: Returns request information for testing and debugging
- Script: Executes scripts using Risor, Starlark, or WebAssembly engines
- MCP: Executes Model Context Protocol tools and functions
Planned:
- Composite: Chains multiple script apps in sequence
Usage
Apps are created during configuration validation and stored in an AppInstances map. The HTTP layer looks up apps by ID and calls their HandleHTTP() method to process requests.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type App ¶
type App interface {
// String returns the unique identifier of the application
String() string
// HandleHTTP processes HTTP requests for this application
HandleHTTP(
ctx context.Context,
resp http.ResponseWriter,
req *http.Request,
) error
}
App defines the interface that all applications must implement. This interface defines what applications can do within the server context. Consumers (like HTTP layer) may define their own structurally identical interfaces.
type AppInstances ¶
type AppInstances struct {
// contains filtered or unexported fields
}
AppInstances is an immutable collection of application instances
func NewAppInstances ¶
func NewAppInstances(apps []App) (*AppInstances, error)
NewAppInstances creates a new AppInstances from a slice of App instances
func (*AppInstances) All ¶
func (c *AppInstances) All() iter.Seq[App]
All returns an iterator over all app instances in the collection. This enables clean iteration: for app := range instances.All() { ... }
func (*AppInstances) GetApp ¶
func (c *AppInstances) GetApp(id string) (App, bool)
GetApp retrieves an application instance by ID
func (*AppInstances) String ¶
func (c *AppInstances) String() string
String returns a string representation of the app instances
Source Files
Directories