Detection

The platform package detects the OS family of the running system. The agent uses it to select the correct provider implementation (Debian, Darwin, or generic Linux). SDK consumers can use it to make platform-aware decisions.

Usage

import "github.com/retr0h/osapi/pkg/sdk/platform"

family := platform.Detect()
// Returns: "debian", "darwin", or "" (unknown/unsupported)

OS Families

OSAPI follows Ansible's OS family naming:

Family	Distributions	Provider Files
debian	Ubuntu, Debian, Raspbian	debian_*.go
darwin	macOS	darwin_*.go

Distributions within the same family share the same provider implementations. For example, Ubuntu 24.04 and Debian 12 both use the debian_*.go providers because they share the same system interfaces (/proc, /sys, ip, etc.).

How It Works

Detect() calls gopsutil/host.Info() to get the platform name, then maps it to an OS family:

• "ubuntu", "debian", "raspbian" → "debian"
• "darwin" (or empty platform with OS=darwin) → "darwin"
• Anything else → returned as-is (falls through to generic Linux providers)

Provider Selection

The agent's ProviderFactory uses the family name to select providers:

switch platform.Detect() {
case "debian":
    hostProvider = host.NewDebianProvider()
case "darwin":
    hostProvider = host.NewDarwinProvider()
default:
    hostProvider = host.NewLinuxProvider() // stub
}

Adding a New OS Family

1. Add the family to supportedFamilies in internal/cli/validate.go
2. Add the distribution mapping to debianFamily (or create a new map) in pkg/sdk/platform/platform.go
3. Create provider files: {family}_*.go (e.g., redhat_get_hostname.go)
4. Add a case to each provider switch in internal/agent/factory.go