modsecurity 1.0.0

//! Intervention related types and methods.

use crate::bindings::{types::ModSecurityIntervention_t, Bindings, RawBindings};
use std::{ffi::CStr, fmt::Debug, marker::PhantomData};

/// Represents an intervention from ModSecurity.
pub struct Intervention<B: RawBindings = Bindings> {
    pub(crate) inner: ModSecurityIntervention_t,
    _bindings: PhantomData<B>,
}

unsafe impl Send for Intervention {}
unsafe impl Sync for Intervention {}

impl<B: RawBindings> Debug for Intervention<B> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Intervention")
            .field("status", &self.status())
            .field("pause", &self.pause())
            .field("url", &self.url())
            .field("log", &self.log())
            .field("disruptive", &self.disruptive())
            .finish()
    }
}

impl<B: RawBindings> Intervention<B> {
    pub(crate) fn new(inner: ModSecurityIntervention_t) -> Self {
        Self {
            inner,
            _bindings: PhantomData,
        }
    }
    /// Returns the status code of the intervention.
    pub fn status(&self) -> i32 {
        self.inner.status
    }

    /// Returns the pause code of the intervention.
    pub fn pause(&self) -> i32 {
        self.inner.pause
    }

    /// Returns the URL, if any, of the intervention.
    pub fn url(&self) -> Option<&str> {
        if self.inner.url.is_null() {
            return None;
        }

        unsafe { CStr::from_ptr(self.inner.url).to_str().ok() }
    }

    /// Returns the log message, if any, of the intervention.
    pub fn log(&self) -> Option<&str> {
        if self.inner.log.is_null() {
            return None;
        }

        unsafe { CStr::from_ptr(self.inner.log).to_str().ok() }
    }

    /// Returns whether the intervention is disruptive.
    pub fn disruptive(&self) -> bool {
        self.inner.disruptive != 0
    }
}

impl<B: RawBindings> Drop for Intervention<B> {
    fn drop(&mut self) {
        unsafe {
            B::msc_intervention_cleanup(&mut self.inner as *mut ModSecurityIntervention_t);
        }
    }
}