Server Facts

from pyinfra import host
from pyinfra.facts.server import Hostname

hostname = host.get_fact(Hostname)
print(f"Hostname: {hostname}")

from pyinfra.facts.server import Kernel

kernel = host.get_fact(Kernel)
# Returns: "Linux" or "Darwin" or "FreeBSD"

from pyinfra.facts.server import KernelVersion

version = host.get_fact(KernelVersion)
# Returns: "5.15.0-56-generic" or similar

from pyinfra.facts.server import Arch

arch = host.get_fact(Arch)
# Returns: "x86_64", "aarch64", "armv7l", etc.

from pyinfra.facts.server import LinuxDistribution

distro = host.get_fact(LinuxDistribution)
print(f"OS: {distro['name']} {distro['version']}")
print(f"Release: {distro['release_meta']['VERSION_ID']}")

from pyinfra.facts.server import User

username = host.get_fact(User)
print(f"Current user: {username}")

from pyinfra.facts.server import Home

# Current user's home
home = host.get_fact(Home)
# Returns: "/home/ubuntu"

# Specific user's home
nginx_home = host.get_fact(Home, user="nginx")
# Returns: "/var/www"

from pyinfra.facts.server import UsersAndGroups

data = host.get_fact(UsersAndGroups)
print(f"Users: {list(data['users'].keys())}")
print(f"Groups: {list(data['groups'].keys())}")

from pyinfra.facts.server import Groups

groups = host.get_fact(Groups)
# Returns: ["root", "daemon", "sudo", "users", ...]

from pyinfra.facts.server import Path

path = host.get_fact(Path)
# Returns: "/usr/local/bin:/usr/bin:/bin"

from pyinfra.facts.server import TmpDir

tmp_dir = host.get_fact(TmpDir)
# Returns: "/tmp" or value of $TMPDIR

from pyinfra.facts.server import Which

# Check if nginx is installed
nginx_path = host.get_fact(Which, command="nginx")
if nginx_path:
    print(f"nginx found at: {nginx_path}")
else:
    print("nginx not installed")

from pyinfra.facts.server import Command

# Get output of command
output = host.get_fact(Command, command="ls /tmp")
print(output)

from pyinfra.facts.server import Date
from datetime import datetime

date = host.get_fact(Date)
print(f"Server time: {date}")

from pyinfra.facts.server import ProcessSnapshot

processes = host.get_fact(ProcessSnapshot)
for pid, proc in processes.items():
    print(f"{pid}: {proc['command']}")

from pyinfra.facts.server import Memory

mem = host.get_fact(Memory)
print(f"Total: {mem['MemTotal']} kB")
print(f"Free: {mem['MemFree']} kB")

from pyinfra.facts.server import Mounts

mounts = host.get_fact(Mounts)
for mount_point, info in mounts.items():
    print(f"{mount_point}: {info['device']} ({info['type']})")

from pyinfra import host
from pyinfra.facts.server import (
    Hostname,
    LinuxDistribution,
    Arch,
    KernelVersion,
    Memory,
    Which,
    Home,
)
from pyinfra.operations import apt, files

# Get system information
hostname = host.get_fact(Hostname)
distro = host.get_fact(LinuxDistribution)
arch = host.get_fact(Arch)
kernel = host.get_fact(KernelVersion)
mem = host.get_fact(Memory)

# Log system info
print(f"""\n=== System Information ===""")
print(f"Hostname: {hostname}")
print(f"OS: {distro['name']} {distro['version']}")
print(f"Architecture: {arch}")
print(f"Kernel: {kernel}")
print(f"Memory: {int(mem['MemTotal']) // 1024} MB")
print()

# Check if required tools are installed
required_tools = ["git", "curl", "vim"]
missing_tools = []

for tool in required_tools:
    if not host.get_fact(Which, command=tool):
        missing_tools.append(tool)

if missing_tools:
    print(f"Installing missing tools: {', '.join(missing_tools)}")
    apt.packages(
        name="Install required tools",
        packages=missing_tools,
        _sudo=True,
    )

# Create directories based on user
current_user = host.get_fact(Home)
files.directory(
    name="Create projects directory",
    path=f"{current_user}/projects",
    present=True,
)

# Conditional operations based on distribution
if distro["name"] == "Ubuntu" and distro["major"] >= 20:
    apt.packages(
        name="Install Ubuntu 20+ packages",
        packages=["systemd", "ufw"],
        _sudo=True,
    )
elif distro["name"] == "Debian":
    apt.packages(
        name="Install Debian packages",
        packages=["systemd", "iptables"],
        _sudo=True,
    )

# Check available memory and warn if low
mem_total_mb = int(mem['MemTotal']) // 1024
mem_free_mb = int(mem['MemFree']) // 1024

if mem_free_mb < 512:
    print(f"⚠️  Warning: Low memory ({mem_free_mb} MB free)")