golazy.dev – golazy.dev / lazyapp Index | Files

package lazyapp ¶

import "golazy.dev/lazyapp"

Package lazyapp composes the framework packages into a runnable GoLazy application.

Most applications use lazyapp.New at the application boundary. It wires the application context, route scope, view renderer, helper registry, asset registry, cache, session manager, robots and configured sitemap endpoints, optional control plane, middleware chain, and public asset fallback into one http.Handler.

The lower-level packages remain independently usable. Use lazyroutes directly for a route table, lazyview and lazycontroller for custom rendering flows, or lazyassets for standalone asset serving. Use lazyapp when those pieces should behave like a conventional GoLazy application.

Variables ¶

var PublicPath ¶

var PublicPath = "app/public"

var ViewsPath ¶

var ViewsPath = "app/views"

Functions ¶

func MustSub ¶

func MustSub(fsys fs.FS, dir string) func() (fs.FS, error)

Types ¶

type App ¶

type App struct {
	Name		string
	Context		context.Context
	Dispatcher	*lazydispatch.Dispatcher
	Router		*lazyroutes.Scope
	Assets		*lazyassets.Registry
	Cache		*lazycache.Cache
	Sessions	*lazysession.Manager
	Jobs		*lazyjobs.JobRunner
	ControlPlane	*lazycontrolplane.ControlPlane
	Dependencies	*lazydeps.Scope
	// contains filtered or unexported fields
}

func New ¶

func New(config Config) *App

func (app *App) ListenAndServe ¶

ListenAndServe starts the app server on ADDR, PORT, or 127.0.0.1:3000.

It installs app.Context as the server base context, so every request context includes the dependencies initialized by New. When using a custom http.Server, set BaseContext to return app.Context.

func (app *App) ListenAndServe() error

func (app *App) ServeHTTP ¶

func (app *App) ServeHTTP(w http.ResponseWriter, r *http.Request)

type Config ¶

type Config struct {
	Name			string
	Drawer			func(*lazyroutes.Scope)
	Public			func() (fs.FS, error)
	Views			func() (fs.FS, error)
	Dependencies		func(*lazydeps.Scope) error
	Helpers			Helpers
	SEO			func(context.Context) []lazyseo.Option
	Assets			[]lazyassets.Source
	AssetOptions		[]lazyassets.Option
	Cache			lazycache.Options
	Robots			RobotsConfig
	Sitemap			SitemapConfig
	Sessions		lazysession.Config
	Jobs			lazyjobs.Config
	ControlPlane		lazycontrolplane.Builder
	Middlewares		[]lazydispatch.Middleware
	ForceDetailErrors	bool
}

type Helpers ¶

type Helpers []map[string]any

type RobotsConfig ¶

type RobotsConfig struct {
	Disabled	bool
	Rules		[]RobotsRule
	Sitemaps	[]string
	Extra		[]string
}

type RobotsRule ¶

type RobotsRule struct {
	UserAgent	string
	Allow		[]string
	Disallow	[]string
	CrawlDelay	string
}

type SitemapAlternate ¶

type SitemapAlternate struct {
	Language	string
	Location	string
}

type SitemapConfig ¶

type SitemapConfig struct {
	Disabled	bool
	BaseURL		string
	URLs		[]SitemapURL
	Sources		[]SitemapSource
}

type SitemapSource ¶

type SitemapSource interface {
	SitemapURLs() ([]SitemapURL, error)
}

type SitemapSourceFunc ¶

type SitemapSourceFunc func() ([]SitemapURL, error)

func (fn SitemapSourceFunc) SitemapURLs ¶

func (fn SitemapSourceFunc) SitemapURLs() ([]SitemapURL, error)

type SitemapURL ¶

type SitemapURL struct {
	Location	string
	LastUpdated	time.Time
	ChangeFreq	string
	Priority	float64
	Alternates	[]SitemapAlternate
}