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

use gio;
use gio_sys;
use glib;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use glib::GString;
use glib_sys;
#[cfg(any(feature = "v1_12", feature = "dox"))]
use gst_rtsp;
use gst_rtsp_server_sys;
#[cfg(any(feature = "v1_16", feature = "dox"))]
use std;
use std::boxed::Box as Box_;
use std::mem::transmute;
use RTSPToken;

glib_wrapper! {
    /// The authentication structure.
    ///
    /// # Implements
    ///
    /// [`RTSPAuthExt`](trait.RTSPAuthExt.html), [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html), [`RTSPAuthExtManual`](prelude/trait.RTSPAuthExtManual.html)
    pub struct RTSPAuth(Object<gst_rtsp_server_sys::GstRTSPAuth, gst_rtsp_server_sys::GstRTSPAuthClass, RTSPAuthClass>);

    match fn {
        get_type => || gst_rtsp_server_sys::gst_rtsp_auth_get_type(),
    }
}

impl RTSPAuth {
    /// Create a new `RTSPAuth` instance.
    ///
    /// # Returns
    ///
    /// a new `RTSPAuth`
    pub fn new() -> RTSPAuth {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_new()) }
    }

    /// Check if `check` is allowed in the current context.
    /// ## `check`
    /// the item to check
    ///
    /// # Returns
    ///
    /// FALSE if check failed.
    pub fn check(check: &str) -> Result<(), glib::error::BoolError> {
        assert_initialized_main_thread!();
        unsafe {
            glib_result_from_gboolean!(
                gst_rtsp_server_sys::gst_rtsp_auth_check(check.to_glib_none().0),
                "Check failed"
            )
        }
    }

    /// Construct a Basic authorisation token from `user` and `pass`.
    /// ## `user`
    /// a userid
    /// ## `pass`
    /// a password
    ///
    /// # Returns
    ///
    /// the base64 encoding of the string `user`:`pass`.
    /// `g_free` after usage.
    pub fn make_basic(user: &str, pass: &str) -> GString {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_make_basic(
                user.to_glib_none().0,
                pass.to_glib_none().0,
            ))
        }
    }
}

impl Default for RTSPAuth {
    fn default() -> Self {
        Self::new()
    }
}

unsafe impl Send for RTSPAuth {}
unsafe impl Sync for RTSPAuth {}

pub const NONE_RTSP_AUTH: Option<&RTSPAuth> = None;

/// Trait containing all `RTSPAuth` methods.
///
/// # Implementors
///
/// [`RTSPAuth`](struct.RTSPAuth.html)
pub trait RTSPAuthExt: 'static {
    /// Add a basic token for the default authentication algorithm that
    /// enables the client with privileges listed in `token`.
    /// ## `basic`
    /// the basic token
    /// ## `token`
    /// authorisation token
    fn add_basic(&self, basic: &str, token: &RTSPToken);

    /// Add a digest `user` and `pass` for the default authentication algorithm that
    /// enables the client with privileges listed in `token`.
    ///
    /// Feature: `v1_12`
    ///
    /// ## `user`
    /// the digest user name
    /// ## `pass`
    /// the digest password
    /// ## `token`
    /// authorisation token
    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn add_digest(&self, user: &str, pass: &str, token: &RTSPToken);

    /// Get the default token for `self`. This token will be used for unauthenticated
    /// users.
    ///
    /// # Returns
    ///
    /// the `RTSPToken` of `self`. `gst_rtsp_token_unref` after
    /// usage.
    fn get_default_token(&self) -> Option<RTSPToken>;

    ///
    /// Feature: `v1_16`
    ///
    ///
    /// # Returns
    ///
    /// the `realm` of `self`
    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn get_realm(&self) -> Option<GString>;

    /// Gets the supported authentication methods of `self`.
    ///
    /// Feature: `v1_12`
    ///
    ///
    /// # Returns
    ///
    /// The supported authentication methods
    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn get_supported_methods(&self) -> gst_rtsp::RTSPAuthMethod;

    /// Get the `gio::TlsAuthenticationMode`.
    ///
    /// # Returns
    ///
    /// the `gio::TlsAuthenticationMode`.
    fn get_tls_authentication_mode(&self) -> gio::TlsAuthenticationMode;

    /// Get the `gio::TlsCertificate` used for negotiating TLS `self`.
    ///
    /// # Returns
    ///
    /// the `gio::TlsCertificate` of `self`. `gobject::ObjectExt::unref` after
    /// usage.
    fn get_tls_certificate(&self) -> Option<gio::TlsCertificate>;

    /// Get the `gio::TlsDatabase` used for verifying client certificate.
    ///
    /// # Returns
    ///
    /// the `gio::TlsDatabase` of `self`. `gobject::ObjectExt::unref` after
    /// usage.
    fn get_tls_database(&self) -> Option<gio::TlsDatabase>;

    /// Parse the contents of the file at `path` and enable the privileges
    /// listed in `token` for the users it describes.
    ///
    /// The format of the file is expected to match the format described by
    /// <https://en.wikipedia.org/wiki/Digest_access_authentication`The_.htdigest_file`>,
    /// as output by the `htdigest` command.
    ///
    /// Feature: `v1_16`
    ///
    /// ## `path`
    /// Path to the htdigest file
    /// ## `token`
    /// authorisation token
    ///
    /// # Returns
    ///
    /// `true` if the file was successfully parsed, `false` otherwise.
    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn parse_htdigest<P: AsRef<std::path::Path>>(&self, path: P, token: &RTSPToken) -> bool;

    /// Removes `basic` authentication token.
    /// ## `basic`
    /// the basic token
    fn remove_basic(&self, basic: &str);

    /// Removes a digest user.
    ///
    /// Feature: `v1_12`
    ///
    /// ## `user`
    /// the digest user name
    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn remove_digest(&self, user: &str);

    /// Set the `realm` of `self`
    ///
    /// Feature: `v1_16`
    ///
    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn set_realm(&self, realm: &str);

    /// Sets the supported authentication `methods` for `self`.
    ///
    /// Feature: `v1_12`
    ///
    /// ## `methods`
    /// supported methods
    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn set_supported_methods(&self, methods: gst_rtsp::RTSPAuthMethod);

    /// The `gio::TlsAuthenticationMode` to set on the underlying GTlsServerConnection.
    /// When set to another value than `gio::TlsAuthenticationMode::None`,
    /// `RTSPAuth::accept-certificate` signal will be emitted and must be handled.
    /// ## `mode`
    /// a `gio::TlsAuthenticationMode`
    fn set_tls_authentication_mode(&self, mode: gio::TlsAuthenticationMode);

    /// Set the TLS certificate for the auth. Client connections will only
    /// be accepted when TLS is negotiated.
    /// ## `cert`
    /// a `gio::TlsCertificate`
    fn set_tls_certificate<P: IsA<gio::TlsCertificate>>(&self, cert: Option<&P>);

    /// Sets the certificate database that is used to verify peer certificates.
    /// If set to `None` (the default), then peer certificate validation will always
    /// set the `gio::TlsCertificateFlags::UnknownCa` error.
    /// ## `database`
    /// a `gio::TlsDatabase`
    fn set_tls_database<P: IsA<gio::TlsDatabase>>(&self, database: Option<&P>);

    /// Emitted during the TLS handshake after the client certificate has
    /// been received. See also `RTSPAuthExt::set_tls_authentication_mode`.
    /// ## `connection`
    /// a `gio::TlsConnection`
    /// ## `peer_cert`
    /// the peer's `gio::TlsCertificate`
    /// ## `errors`
    /// the problems with `peer_cert`.
    ///
    /// # Returns
    ///
    /// `true` to accept `peer_cert` (which will also
    /// immediately end the signal emission). `false` to allow the signal
    /// emission to continue, which will cause the handshake to fail if
    /// no one else overrides it.
    fn connect_accept_certificate<
        F: Fn(&Self, &gio::TlsConnection, &gio::TlsCertificate, gio::TlsCertificateFlags) -> bool
            + Send
            + Sync
            + 'static,
    >(
        &self,
        f: F,
    ) -> SignalHandlerId;
}

impl<O: IsA<RTSPAuth>> RTSPAuthExt for O {
    fn add_basic(&self, basic: &str, token: &RTSPToken) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_add_basic(
                self.as_ref().to_glib_none().0,
                basic.to_glib_none().0,
                token.to_glib_none().0,
            );
        }
    }

    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn add_digest(&self, user: &str, pass: &str, token: &RTSPToken) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_add_digest(
                self.as_ref().to_glib_none().0,
                user.to_glib_none().0,
                pass.to_glib_none().0,
                token.to_glib_none().0,
            );
        }
    }

    fn get_default_token(&self) -> Option<RTSPToken> {
        unsafe {
            from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_get_default_token(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn get_realm(&self) -> Option<GString> {
        unsafe {
            from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_get_realm(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn get_supported_methods(&self) -> gst_rtsp::RTSPAuthMethod {
        unsafe {
            from_glib(gst_rtsp_server_sys::gst_rtsp_auth_get_supported_methods(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_tls_authentication_mode(&self) -> gio::TlsAuthenticationMode {
        unsafe {
            from_glib(
                gst_rtsp_server_sys::gst_rtsp_auth_get_tls_authentication_mode(
                    self.as_ref().to_glib_none().0,
                ),
            )
        }
    }

    fn get_tls_certificate(&self) -> Option<gio::TlsCertificate> {
        unsafe {
            from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_get_tls_certificate(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn get_tls_database(&self) -> Option<gio::TlsDatabase> {
        unsafe {
            from_glib_full(gst_rtsp_server_sys::gst_rtsp_auth_get_tls_database(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn parse_htdigest<P: AsRef<std::path::Path>>(&self, path: P, token: &RTSPToken) -> bool {
        unsafe {
            from_glib(gst_rtsp_server_sys::gst_rtsp_auth_parse_htdigest(
                self.as_ref().to_glib_none().0,
                path.as_ref().to_glib_none().0,
                token.to_glib_none().0,
            ))
        }
    }

    fn remove_basic(&self, basic: &str) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_remove_basic(
                self.as_ref().to_glib_none().0,
                basic.to_glib_none().0,
            );
        }
    }

    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn remove_digest(&self, user: &str) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_remove_digest(
                self.as_ref().to_glib_none().0,
                user.to_glib_none().0,
            );
        }
    }

    #[cfg(any(feature = "v1_16", feature = "dox"))]
    fn set_realm(&self, realm: &str) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_set_realm(
                self.as_ref().to_glib_none().0,
                realm.to_glib_none().0,
            );
        }
    }

    #[cfg(any(feature = "v1_12", feature = "dox"))]
    fn set_supported_methods(&self, methods: gst_rtsp::RTSPAuthMethod) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_set_supported_methods(
                self.as_ref().to_glib_none().0,
                methods.to_glib(),
            );
        }
    }

    fn set_tls_authentication_mode(&self, mode: gio::TlsAuthenticationMode) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_set_tls_authentication_mode(
                self.as_ref().to_glib_none().0,
                mode.to_glib(),
            );
        }
    }

    fn set_tls_certificate<P: IsA<gio::TlsCertificate>>(&self, cert: Option<&P>) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_set_tls_certificate(
                self.as_ref().to_glib_none().0,
                cert.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    fn set_tls_database<P: IsA<gio::TlsDatabase>>(&self, database: Option<&P>) {
        unsafe {
            gst_rtsp_server_sys::gst_rtsp_auth_set_tls_database(
                self.as_ref().to_glib_none().0,
                database.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    fn connect_accept_certificate<
        F: Fn(&Self, &gio::TlsConnection, &gio::TlsCertificate, gio::TlsCertificateFlags) -> bool
            + Send
            + Sync
            + 'static,
    >(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn accept_certificate_trampoline<
            P,
            F: Fn(&P, &gio::TlsConnection, &gio::TlsCertificate, gio::TlsCertificateFlags) -> bool
                + Send
                + Sync
                + 'static,
        >(
            this: *mut gst_rtsp_server_sys::GstRTSPAuth,
            connection: *mut gio_sys::GTlsConnection,
            peer_cert: *mut gio_sys::GTlsCertificate,
            errors: gio_sys::GTlsCertificateFlags,
            f: glib_sys::gpointer,
        ) -> glib_sys::gboolean
        where
            P: IsA<RTSPAuth>,
        {
            let f: &F = &*(f as *const F);
            f(
                &RTSPAuth::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(connection),
                &from_glib_borrow(peer_cert),
                from_glib(errors),
            )
            .to_glib()
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"accept-certificate\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    accept_certificate_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}