// 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::*};
use std::fmt;

glib::wrapper! {
    /// TLS (Transport Layer Security, aka SSL) and DTLS 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 [`TlsBackend`][crate::TlsBackend] for the system.
    ///
    /// # Returns
    ///
    /// a [`TlsBackend`][crate::TlsBackend], 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 [`TlsCertificate`][crate::TlsCertificate] implementation.
    ///
    /// # Returns
    ///
    /// the `GType` of `self`'s [`TlsCertificate`][crate::TlsCertificate]
    ///  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 [`TlsClientConnection`][crate::TlsClientConnection] implementation.
    ///
    /// # Returns
    ///
    /// the `GType` of `self`'s [`TlsClientConnection`][crate::TlsClientConnection]
    ///  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 [`TlsDatabase`][crate::TlsDatabase] 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 [`TlsFileDatabase`][crate::TlsFileDatabase] implementation.
    ///
    /// # Returns
    ///
    /// the `GType` of backend's [`TlsFileDatabase`][crate::TlsFileDatabase] 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 [`TlsServerConnection`][crate::TlsServerConnection] implementation.
    ///
    /// # Returns
    ///
    /// the `GType` of `self`'s [`TlsServerConnection`][crate::TlsServerConnection]
    ///  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 [`TlsDatabase`][crate::TlsDatabase] used to verify TLS connections
    ///
    /// Any subsequent call to [`default_database()`][Self::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 [`set_default_database()`][Self::set_default_database()] had never been called.
    /// ## `database`
    /// the [`TlsDatabase`][crate::TlsDatabase]
    #[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
    /// [`TlsBackend`][crate::TlsBackend], 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 {}

impl fmt::Display for TlsBackend {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("TlsBackend")
    }
}