// 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 crate::TlsDatabase;
use glib::{prelude::*, translate::*};

glib::wrapper! {
    /// TLS (Transport Layer Security, aka SSL) and DTLS backend. This is an
    /// internal type used to coordinate the different classes implemented
    /// by a TLS backend.
    ///
    /// # Implements
    ///
    /// [`TlsBackendExt`][trait@crate::prelude::TlsBackendExt]
    #[doc(alias = "GTlsBackend")]
    pub struct TlsBackend(Interface<ffi::GTlsBackend, ffi::GTlsBackendInterface>);

    match fn {
        type_ => || ffi::g_tls_backend_get_type(),
    }
}

impl TlsBackend {
    pub const NONE: Option<&'static TlsBackend> = None;

    /// Gets the default #GTlsBackend for the system.
    ///
    /// # Returns
    ///
    /// a #GTlsBackend, which will be a
    ///     dummy object if no TLS backend is available
    #[doc(alias = "g_tls_backend_get_default")]
    #[doc(alias = "get_default")]
    #[allow(clippy::should_implement_trait)]
    pub fn default() -> TlsBackend {
        unsafe { from_glib_none(ffi::g_tls_backend_get_default()) }
    }
}

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::TlsBackend>> Sealed for T {}
}

/// Trait containing all [`struct@TlsBackend`] methods.
///
/// # Implementors
///
/// [`TlsBackend`][struct@crate::TlsBackend]
pub trait TlsBackendExt: IsA<TlsBackend> + sealed::Sealed + 'static {
    /// Gets the #GType of @self's #GTlsCertificate implementation.
    ///
    /// # Returns
    ///
    /// the #GType of @self's #GTlsCertificate
    ///   implementation.
    #[doc(alias = "g_tls_backend_get_certificate_type")]
    #[doc(alias = "get_certificate_type")]
    fn certificate_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_certificate_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the #GType of @self's #GTlsClientConnection implementation.
    ///
    /// # Returns
    ///
    /// the #GType of @self's #GTlsClientConnection
    ///   implementation.
    #[doc(alias = "g_tls_backend_get_client_connection_type")]
    #[doc(alias = "get_client_connection_type")]
    fn client_connection_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_client_connection_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the default #GTlsDatabase used to verify TLS connections.
    ///
    /// # Returns
    ///
    /// the default database, which should be
    ///               unreffed when done.
    #[doc(alias = "g_tls_backend_get_default_database")]
    #[doc(alias = "get_default_database")]
    fn default_database(&self) -> TlsDatabase {
        unsafe {
            from_glib_full(ffi::g_tls_backend_get_default_database(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the #GType of @self’s #GDtlsClientConnection implementation.
    ///
    /// # Returns
    ///
    /// the #GType of @self’s #GDtlsClientConnection
    ///   implementation, or `G_TYPE_INVALID` if this backend doesn’t support DTLS.
    #[doc(alias = "g_tls_backend_get_dtls_client_connection_type")]
    #[doc(alias = "get_dtls_client_connection_type")]
    fn dtls_client_connection_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_dtls_client_connection_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the #GType of @self’s #GDtlsServerConnection implementation.
    ///
    /// # Returns
    ///
    /// the #GType of @self’s #GDtlsServerConnection
    ///   implementation, or `G_TYPE_INVALID` if this backend doesn’t support DTLS.
    #[doc(alias = "g_tls_backend_get_dtls_server_connection_type")]
    #[doc(alias = "get_dtls_server_connection_type")]
    fn dtls_server_connection_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_dtls_server_connection_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the #GType of @self's #GTlsFileDatabase implementation.
    ///
    /// # Returns
    ///
    /// the #GType of backend's #GTlsFileDatabase implementation.
    #[doc(alias = "g_tls_backend_get_file_database_type")]
    #[doc(alias = "get_file_database_type")]
    fn file_database_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_file_database_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the #GType of @self's #GTlsServerConnection implementation.
    ///
    /// # Returns
    ///
    /// the #GType of @self's #GTlsServerConnection
    ///   implementation.
    #[doc(alias = "g_tls_backend_get_server_connection_type")]
    #[doc(alias = "get_server_connection_type")]
    fn server_connection_type(&self) -> glib::types::Type {
        unsafe {
            from_glib(ffi::g_tls_backend_get_server_connection_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Set the default #GTlsDatabase used to verify TLS connections
    ///
    /// Any subsequent call to g_tls_backend_get_default_database() will return
    /// the database set in this call.  Existing databases and connections are not
    /// modified.
    ///
    /// Setting a [`None`] default database will reset to using the system default
    /// database as if g_tls_backend_set_default_database() had never been called.
    /// ## `database`
    /// the #GTlsDatabase
    #[cfg(feature = "v2_60")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v2_60")))]
    #[doc(alias = "g_tls_backend_set_default_database")]
    fn set_default_database(&self, database: Option<&impl IsA<TlsDatabase>>) {
        unsafe {
            ffi::g_tls_backend_set_default_database(
                self.as_ref().to_glib_none().0,
                database.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Checks if DTLS is supported. DTLS support may not be available even if TLS
    /// support is available, and vice-versa.
    ///
    /// # Returns
    ///
    /// whether DTLS is supported
    #[doc(alias = "g_tls_backend_supports_dtls")]
    fn supports_dtls(&self) -> bool {
        unsafe {
            from_glib(ffi::g_tls_backend_supports_dtls(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Checks if TLS is supported; if this returns [`false`] for the default
    /// #GTlsBackend, it means no "real" TLS backend is available.
    ///
    /// # Returns
    ///
    /// whether or not TLS is supported
    #[doc(alias = "g_tls_backend_supports_tls")]
    fn supports_tls(&self) -> bool {
        unsafe {
            from_glib(ffi::g_tls_backend_supports_tls(
                self.as_ref().to_glib_none().0,
            ))
        }
    }
}

impl<O: IsA<TlsBackend>> TlsBackendExt for O {}