mgf-vm 0.2.1

KVM/QEMU virtual-machine domain library for the Magogi Foundation

mgf-vm

KVM/QEMU virtual-machine domain library for the Magogi Foundation.

mgf-vm is the reusable VM-management core — VM lifecycle, creation, configuration, monitoring, networking, storage, host-environment setup, security isolation, and forensics — carved out so any consumer (a CLI, a GUI, a service) can build on it without re-implementing the domain.

• Import: import mgf.vm — mgf is a PEP 420 namespace package.
• Install: pip install mgf-vm (from the foundation's private index).
• Provider seam: no module imports libvirt directly — every hypervisor call goes through the VMProvider ABC, with a MockProvider for tests.

Conformance: L2 per mgf-common/docs/standards/. Tracker: docs/inprogress/MGF_STANDARDS_CONFORMANCE.md. Four declined groups (DEP / GUI_CONSUMERS / PRESENTATION_LAYER / WORKFLOWS) all per SP-02 layering — mgf-vm is a domain library; presentation + deployment belong in consumers.

Place in the federation

mgf-vm is a federation library (sibling): it depends only on mgf-common and never on another mgf-* sibling or on a consumer application. The reference consumer is the VManager CLI/GUI app.

See docs/CLAUDE.md for the project reference, SCOPE.md for what does and does not belong here, and USERS.md for the consumers.

libvirt-python

libvirt-python is not a pip dependency — it ships as the system package python3-libvirt, ABI-matched to libvirt-daemon-system. Create dev environments with uv venv --system-site-packages. The unit suite runs entirely against MockProvider and needs no real libvirt.

Development

uv venv --system-site-packages
uv pip install -e ".[dev]"
ruff check src tests
mypy
lint-imports
pytest