gstreamer-rs/gstreamer-controller/sys/tests/abi.rs

// This file was generated by gir (https://github.com/gtk-rs/gir @ c85699a)
// from gir-files (https://github.com/gtk-rs/gir-files @ 796f93f7)
// DO NOT EDIT

use gstreamer_controller_sys::*;
use std::env;
use std::error::Error;
use std::mem::{align_of, size_of};
use std::path::Path;
use std::process::Command;
use std::str;
use tempfile::Builder;

static PACKAGES: &[&str] = &["gstreamer-controller-1.0"];

#[derive(Clone, Debug)]
struct Compiler {
    pub args: Vec<String>,
}

impl Compiler {
    pub fn new() -> Result<Compiler, Box<dyn Error>> {
        let mut args = get_var("CC", "cc")?;
        args.push("-Wno-deprecated-declarations".to_owned());
        // For %z support in printf when using MinGW.
        args.push("-D__USE_MINGW_ANSI_STDIO".to_owned());
        args.extend(get_var("CFLAGS", "")?);
        args.extend(get_var("CPPFLAGS", "")?);
        args.extend(pkg_config_cflags(PACKAGES)?);
        Ok(Compiler { args })
    }

    pub fn define<'a, V: Into<Option<&'a str>>>(&mut self, var: &str, val: V) {
        let arg = match val.into() {
            None => format!("-D{}", var),
            Some(val) => format!("-D{}={}", var, val),
        };
        self.args.push(arg);
    }

    pub fn compile(&self, src: &Path, out: &Path) -> Result<(), Box<dyn Error>> {
        let mut cmd = self.to_command();
        cmd.arg(src);
        cmd.arg("-o");
        cmd.arg(out);
        let status = cmd.spawn()?.wait()?;
        if !status.success() {
            return Err(format!("compilation command {:?} failed, {}", &cmd, status).into());
        }
        Ok(())
    }

    fn to_command(&self) -> Command {
        let mut cmd = Command::new(&self.args[0]);
        cmd.args(&self.args[1..]);
        cmd
    }
}

fn get_var(name: &str, default: &str) -> Result<Vec<String>, Box<dyn Error>> {
    match env::var(name) {
        Ok(value) => Ok(shell_words::split(&value)?),
        Err(env::VarError::NotPresent) => Ok(shell_words::split(default)?),
        Err(err) => Err(format!("{} {}", name, err).into()),
    }
}

fn pkg_config_cflags(packages: &[&str]) -> Result<Vec<String>, Box<dyn Error>> {
    if packages.is_empty() {
        return Ok(Vec::new());
    }
    let mut cmd = Command::new("pkg-config");
    cmd.arg("--cflags");
    cmd.args(packages);
    let out = cmd.output()?;
    if !out.status.success() {
        return Err(format!("command {:?} returned {}", &cmd, out.status).into());
    }
    let stdout = str::from_utf8(&out.stdout)?;
    Ok(shell_words::split(stdout.trim())?)
}

#[derive(Copy, Clone, Debug, Eq, PartialEq)]
struct Layout {
    size: usize,
    alignment: usize,
}

#[derive(Copy, Clone, Debug, Default, Eq, PartialEq)]
struct Results {
    /// Number of successfully completed tests.
    passed: usize,
    /// Total number of failed tests (including those that failed to compile).
    failed: usize,
    /// Number of tests that failed to compile.
    failed_to_compile: usize,
}

impl Results {
    fn record_passed(&mut self) {
        self.passed += 1;
    }
    fn record_failed(&mut self) {
        self.failed += 1;
    }
    fn record_failed_to_compile(&mut self) {
        self.failed += 1;
        self.failed_to_compile += 1;
    }
    fn summary(&self) -> String {
        format!(
            "{} passed; {} failed (compilation errors: {})",
            self.passed, self.failed, self.failed_to_compile
        )
    }
    fn expect_total_success(&self) {
        if self.failed == 0 {
            println!("OK: {}", self.summary());
        } else {
            panic!("FAILED: {}", self.summary());
        };
    }
}

#[test]
fn cross_validate_constants_with_c() {
    let tmpdir = Builder::new()
        .prefix("abi")
        .tempdir()
        .expect("temporary directory");
    let cc = Compiler::new().expect("configured compiler");

    assert_eq!(
        "1",
        get_c_value(tmpdir.path(), &cc, "1").expect("C constant"),
        "failed to obtain correct constant value for 1"
    );

    let mut results: Results = Default::default();
    for (i, &(name, rust_value)) in RUST_CONSTANTS.iter().enumerate() {
        match get_c_value(tmpdir.path(), &cc, name) {
            Err(e) => {
                results.record_failed_to_compile();
                eprintln!("{}", e);
            }
            Ok(ref c_value) => {
                if rust_value == c_value {
                    results.record_passed();
                } else {
                    results.record_failed();
                    eprintln!(
                        "Constant value mismatch for {}\nRust: {:?}\nC:    {:?}",
                        name, rust_value, c_value
                    );
                }
            }
        };
        if (i + 1) % 25 == 0 {
            println!("constants ... {}", results.summary());
        }
    }
    results.expect_total_success();
}

#[test]
fn cross_validate_layout_with_c() {
    let tmpdir = Builder::new()
        .prefix("abi")
        .tempdir()
        .expect("temporary directory");
    let cc = Compiler::new().expect("configured compiler");

    assert_eq!(
        Layout {
            size: 1,
            alignment: 1
        },
        get_c_layout(tmpdir.path(), &cc, "char").expect("C layout"),
        "failed to obtain correct layout for char type"
    );

    let mut results: Results = Default::default();
    for (i, &(name, rust_layout)) in RUST_LAYOUTS.iter().enumerate() {
        match get_c_layout(tmpdir.path(), &cc, name) {
            Err(e) => {
                results.record_failed_to_compile();
                eprintln!("{}", e);
            }
            Ok(c_layout) => {
                if rust_layout == c_layout {
                    results.record_passed();
                } else {
                    results.record_failed();
                    eprintln!(
                        "Layout mismatch for {}\nRust: {:?}\nC:    {:?}",
                        name, rust_layout, &c_layout
                    );
                }
            }
        };
        if (i + 1) % 25 == 0 {
            println!("layout    ... {}", results.summary());
        }
    }
    results.expect_total_success();
}

fn get_c_layout(dir: &Path, cc: &Compiler, name: &str) -> Result<Layout, Box<dyn Error>> {
    let exe = dir.join("layout");
    let mut cc = cc.clone();
    cc.define("ABI_TYPE_NAME", name);
    cc.compile(Path::new("tests/layout.c"), &exe)?;

    let mut abi_cmd = Command::new(exe);
    let output = abi_cmd.output()?;
    if !output.status.success() {
        return Err(format!("command {:?} failed, {:?}", &abi_cmd, &output).into());
    }

    let stdout = str::from_utf8(&output.stdout)?;
    let mut words = stdout.trim().split_whitespace();
    let size = words.next().unwrap().parse().unwrap();
    let alignment = words.next().unwrap().parse().unwrap();
    Ok(Layout { size, alignment })
}

fn get_c_value(dir: &Path, cc: &Compiler, name: &str) -> Result<String, Box<dyn Error>> {
    let exe = dir.join("constant");
    let mut cc = cc.clone();
    cc.define("ABI_CONSTANT_NAME", name);
    cc.compile(Path::new("tests/constant.c"), &exe)?;

    let mut abi_cmd = Command::new(exe);
    let output = abi_cmd.output()?;
    if !output.status.success() {
        return Err(format!("command {:?} failed, {:?}", &abi_cmd, &output).into());
    }

    let output = str::from_utf8(&output.stdout)?.trim();
    if !output.starts_with("###gir test###") || !output.ends_with("###gir test###") {
        return Err(format!(
            "command {:?} return invalid output, {:?}",
            &abi_cmd, &output
        )
        .into());
    }

    Ok(String::from(&output[14..(output.len() - 14)]))
}

const RUST_LAYOUTS: &[(&str, Layout)] = &[
    (
        "GstARGBControlBinding",
        Layout {
            size: size_of::<GstARGBControlBinding>(),
            alignment: align_of::<GstARGBControlBinding>(),
        },
    ),
    (
        "GstARGBControlBindingClass",
        Layout {
            size: size_of::<GstARGBControlBindingClass>(),
            alignment: align_of::<GstARGBControlBindingClass>(),
        },
    ),
    (
        "GstControlPoint",
        Layout {
            size: size_of::<GstControlPoint>(),
            alignment: align_of::<GstControlPoint>(),
        },
    ),
    (
        "GstDirectControlBinding",
        Layout {
            size: size_of::<GstDirectControlBinding>(),
            alignment: align_of::<GstDirectControlBinding>(),
        },
    ),
    (
        "GstDirectControlBindingClass",
        Layout {
            size: size_of::<GstDirectControlBindingClass>(),
            alignment: align_of::<GstDirectControlBindingClass>(),
        },
    ),
    (
        "GstInterpolationControlSource",
        Layout {
            size: size_of::<GstInterpolationControlSource>(),
            alignment: align_of::<GstInterpolationControlSource>(),
        },
    ),
    (
        "GstInterpolationControlSourceClass",
        Layout {
            size: size_of::<GstInterpolationControlSourceClass>(),
            alignment: align_of::<GstInterpolationControlSourceClass>(),
        },
    ),
    (
        "GstInterpolationMode",
        Layout {
            size: size_of::<GstInterpolationMode>(),
            alignment: align_of::<GstInterpolationMode>(),
        },
    ),
    (
        "GstLFOControlSource",
        Layout {
            size: size_of::<GstLFOControlSource>(),
            alignment: align_of::<GstLFOControlSource>(),
        },
    ),
    (
        "GstLFOControlSourceClass",
        Layout {
            size: size_of::<GstLFOControlSourceClass>(),
            alignment: align_of::<GstLFOControlSourceClass>(),
        },
    ),
    (
        "GstLFOWaveform",
        Layout {
            size: size_of::<GstLFOWaveform>(),
            alignment: align_of::<GstLFOWaveform>(),
        },
    ),
    (
        "GstProxyControlBinding",
        Layout {
            size: size_of::<GstProxyControlBinding>(),
            alignment: align_of::<GstProxyControlBinding>(),
        },
    ),
    (
        "GstProxyControlBindingClass",
        Layout {
            size: size_of::<GstProxyControlBindingClass>(),
            alignment: align_of::<GstProxyControlBindingClass>(),
        },
    ),
    (
        "GstTimedValueControlSource",
        Layout {
            size: size_of::<GstTimedValueControlSource>(),
            alignment: align_of::<GstTimedValueControlSource>(),
        },
    ),
    (
        "GstTimedValueControlSourceClass",
        Layout {
            size: size_of::<GstTimedValueControlSourceClass>(),
            alignment: align_of::<GstTimedValueControlSourceClass>(),
        },
    ),
    (
        "GstTriggerControlSource",
        Layout {
            size: size_of::<GstTriggerControlSource>(),
            alignment: align_of::<GstTriggerControlSource>(),
        },
    ),
    (
        "GstTriggerControlSourceClass",
        Layout {
            size: size_of::<GstTriggerControlSourceClass>(),
            alignment: align_of::<GstTriggerControlSourceClass>(),
        },
    ),
];

const RUST_CONSTANTS: &[(&str, &str)] = &[
    ("(gint) GST_INTERPOLATION_MODE_CUBIC", "2"),
    ("(gint) GST_INTERPOLATION_MODE_CUBIC_MONOTONIC", "3"),
    ("(gint) GST_INTERPOLATION_MODE_LINEAR", "1"),
    ("(gint) GST_INTERPOLATION_MODE_NONE", "0"),
    ("(gint) GST_LFO_WAVEFORM_REVERSE_SAW", "3"),
    ("(gint) GST_LFO_WAVEFORM_SAW", "2"),
    ("(gint) GST_LFO_WAVEFORM_SINE", "0"),
    ("(gint) GST_LFO_WAVEFORM_SQUARE", "1"),
    ("(gint) GST_LFO_WAVEFORM_TRIANGLE", "4"),
];