server

package

v0.1.2 Latest Latest Go to latest Published: Feb 14, 2026 License: MIT Imports: 17 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/a-digi/coco-server

Links

Open Source Insights

Documentation ¶

Index ¶

Constants
func EnsurePortIsFree(port int, log logger.Logger)
func GracefulShutdown(server *http.Server, pidFile string, log logger.Logger)
func IsPortBusy(port int) (bool, int, error)
func LogFileName(prefix string) string
func ReadPID(pidFile string) (int, error)
func RemovePID(pidFile string) error
func SendSIGTERM(pid int) error
func ShutdownServer(configPath string, log logger.Logger) error
func WaitForPortFreed(port int, log logger.Logger)
func WritePID(pidFile string) error
type Config
- func LoadConfig(path string) (*Config, error)
- func StartServer(configPath string, log logger.Logger) (*http.Server, *Config, error)
type DomainFile
type DomainRule

Constants ¶

View Source

const DefaultPort = 2026

Variables ¶

This section is empty.

Functions ¶

func EnsurePortIsFree ¶

func EnsurePortIsFree(port int, log logger.Logger)

EnsurePortIsFree prüft, ob der Port frei ist. Falls nicht, wird der Prozess per Port-Suche gekillt und gewartet, bis der Port frei ist.

func GracefulShutdown ¶

func GracefulShutdown(server *http.Server, pidFile string, log logger.Logger)

GracefulShutdown wartet immer selbst auf SIGTERM/SIGINT und loggt das Signal.

func IsPortBusy ¶

func IsPortBusy(port int) (bool, int, error)

IsPortBusy prüft, ob der Port bereits belegt ist. Gibt ggf. die PID des Prozesses zurück (immer 0, da Go das nicht nativ unterstützt).

func LogFileName ¶

func LogFileName(prefix string) string

LogFileName returns a log file name based on the current datetime (YYYYMMDD_HHMMSS.log)

func ReadPID ¶

func ReadPID(pidFile string) (int, error)

ReadPID reads the PID from the specified file

func RemovePID ¶

func RemovePID(pidFile string) error

RemovePID removes the PID file

func SendSIGTERM ¶

func SendSIGTERM(pid int) error

func ShutdownServer ¶

func ShutdownServer(configPath string, log logger.Logger) error

func WaitForPortFreed ¶

func WaitForPortFreed(port int, log logger.Logger)

WaitForPortFreed wartet, bis der Port nicht mehr belegt ist (Timeout: 10s)

func WritePID ¶

func WritePID(pidFile string) error

WritePID writes the current process PID to the specified file

Types ¶

type Config ¶

type Config struct {
	Port        int      `json:"port"`
	PidFile     string   `json:"pid_file"`
	DomainFiles []string `json:"domain_files,omitempty"`
}

func LoadConfig ¶

func LoadConfig(path string) (*Config, error)

func StartServer ¶

func StartServer(configPath string, log logger.Logger) (*http.Server, *Config, error)

StartServer starts the HTTP server and returns the server instance and config.

type DomainFile ¶

type DomainFile struct {
	Name        string       `json:"name"`
	Description string       `json:"description"`
	Rules       []DomainRule `json:"rules"`
}

type DomainRule ¶

type DomainRule struct {
	ID      string `json:"id"`
	Pattern string `json:"pattern"`
	Action  string `json:"action"`
}

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
di
request
response
routing

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL