everruns-integrations-docker 0.12.0

Docker container integration for Everruns
Documentation
//! Integration test: verify Docker Container plugin registers via inventory.

use everruns_core::capabilities::{CapabilityRegistry, IntegrationPlugin};
use everruns_core::deployment::DeploymentGrade;

// Force linker to include the integration crate's inventory submissions.
use everruns_integrations_docker as _;

// Env-var-mutating tests must not run in parallel.
static ENV_LOCK: std::sync::Mutex<()> = std::sync::Mutex::new(());

fn lock_env() -> std::sync::MutexGuard<'static, ()> {
    ENV_LOCK.lock().unwrap_or_else(|e| e.into_inner())
}

#[test]
fn test_docker_plugin_is_submitted() {
    let plugins: Vec<&IntegrationPlugin> = inventory::iter::<IntegrationPlugin>().collect();
    assert!(
        plugins.iter().any(|p| {
            let cap = (p.factory)();
            cap.id() == "docker_container"
        }),
        "Docker Container IntegrationPlugin should be submitted via inventory"
    );
}

#[test]
fn test_docker_plugin_is_experimental() {
    let plugins: Vec<&IntegrationPlugin> = inventory::iter::<IntegrationPlugin>().collect();
    let docker = plugins
        .iter()
        .find(|p| {
            let cap = (p.factory)();
            cap.id() == "docker_container"
        })
        .expect("Docker Container plugin not found");

    assert!(
        docker.experimental_only,
        "Docker Container should be marked experimental_only"
    );
}

#[test]
fn test_docker_plugin_has_feature_flag() {
    let plugins: Vec<&IntegrationPlugin> = inventory::iter::<IntegrationPlugin>().collect();
    let docker = plugins
        .iter()
        .find(|p| {
            let cap = (p.factory)();
            cap.id() == "docker_container"
        })
        .expect("Docker Container plugin not found");

    assert_eq!(
        docker.feature_flag,
        Some("docker_capability"),
        "Docker Container should be gated by 'docker_capability' feature flag"
    );
}

#[test]
fn test_docker_not_registered_in_dev_without_flag() {
    let _lock = lock_env();
    // Docker requires FEATURE_DOCKER_CAPABILITY=true even in dev
    unsafe { std::env::remove_var("FEATURE_DOCKER_CAPABILITY") };
    let registry = CapabilityRegistry::with_builtins_for_grade(DeploymentGrade::Dev);
    assert!(
        !registry.has("docker_container"),
        "Docker Container should NOT be in dev registry without FEATURE_DOCKER_CAPABILITY"
    );
}

#[test]
fn test_docker_registered_in_dev_with_flag() {
    let _lock = lock_env();
    unsafe { std::env::set_var("FEATURE_DOCKER_CAPABILITY", "true") };
    let registry = CapabilityRegistry::with_builtins_for_grade(DeploymentGrade::Dev);
    assert!(
        registry.has("docker_container"),
        "Docker Container should be in dev registry when FEATURE_DOCKER_CAPABILITY=true"
    );
    unsafe { std::env::remove_var("FEATURE_DOCKER_CAPABILITY") };
}

#[test]
fn test_docker_not_registered_in_prod_registry() {
    let _lock = lock_env();
    unsafe { std::env::remove_var("FEATURE_DOCKER_CAPABILITY") };
    let registry = CapabilityRegistry::with_builtins_for_grade(DeploymentGrade::Prod);
    assert!(
        !registry.has("docker_container"),
        "Docker Container should NOT be in prod registry"
    );
}

#[test]
fn test_docker_not_registered_in_prod_even_with_flag() {
    let _lock = lock_env();
    // experimental_only still blocks prod (grade must also allow experimental)
    unsafe { std::env::set_var("FEATURE_DOCKER_CAPABILITY", "true") };
    let registry = CapabilityRegistry::with_builtins_for_grade(DeploymentGrade::Prod);
    assert!(
        !registry.has("docker_container"),
        "Docker Container should NOT be in prod registry (experimental_only blocks it)"
    );
    unsafe { std::env::remove_var("FEATURE_DOCKER_CAPABILITY") };
}

#[test]
fn test_docker_capability_metadata() {
    let _lock = lock_env();
    unsafe { std::env::set_var("FEATURE_DOCKER_CAPABILITY", "true") };
    let registry = CapabilityRegistry::with_builtins_for_grade(DeploymentGrade::Dev);
    let cap = registry
        .get("docker_container")
        .expect("Docker Container capability not found");

    assert_eq!(cap.id(), "docker_container");
    assert_eq!(cap.name(), "[Experimental] Docker Container");
    assert_eq!(cap.icon(), Some("container"));
    assert_eq!(cap.category(), Some("Sandboxes"));
    assert_eq!(cap.tools().len(), 5);
    unsafe { std::env::remove_var("FEATURE_DOCKER_CAPABILITY") };
}