// 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
#![allow(deprecated)]

use crate::{
    AsyncResult, Cancellable, IOStream, ProxyResolver, SocketAddress, SocketClientEvent,
    SocketConnectable, SocketConnection, SocketFamily, SocketProtocol, SocketType,
    TlsCertificateFlags,
};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute, pin::Pin, ptr};

glib::wrapper! {
    /// [`SocketClient`][crate::SocketClient] is a lightweight high-level utility class for connecting to
    /// a network host using a connection oriented socket type.
    ///
    /// You create a [`SocketClient`][crate::SocketClient] object, set any options you want, and then
    /// call a sync or async connect operation, which returns a [`SocketConnection`][crate::SocketConnection]
    /// subclass on success.
    ///
    /// The type of the [`SocketConnection`][crate::SocketConnection] object returned depends on the type of
    /// the underlying socket that is in use. For instance, for a TCP/IP connection
    /// it will be a [`TcpConnection`][crate::TcpConnection].
    ///
    /// As [`SocketClient`][crate::SocketClient] is a lightweight object, you don't need to cache it. You
    /// can just create a new one any time you need one.
    ///
    /// ## Properties
    ///
    ///
    /// #### `enable-proxy`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `family`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `local-address`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `protocol`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `proxy-resolver`
    ///  The proxy resolver to use
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `timeout`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `tls`
    ///  Readable | Writeable | Construct
    ///
    ///
    /// #### `tls-validation-flags`
    ///  The TLS validation flags used when creating TLS connections. The
    /// default value is [`TlsCertificateFlags::VALIDATE_ALL`][crate::TlsCertificateFlags::VALIDATE_ALL].
    ///
    /// GLib guarantees that if certificate verification fails, at least one
    /// flag will be set, but it does not guarantee that all possible flags
    /// will be set. Accordingly, you may not safely decide to ignore any
    /// particular type of error. For example, it would be incorrect to mask
    /// [`TlsCertificateFlags::EXPIRED`][crate::TlsCertificateFlags::EXPIRED] if you want to allow expired certificates,
    /// because this could potentially be the only error flag set even if
    /// other problems exist with the certificate. Therefore, there is no
    /// safe way to use this property. This is not a horrible problem,
    /// though, because you should not be attempting to ignore validation
    /// errors anyway. If you really must ignore TLS certificate errors,
    /// connect to the [`event`][struct@crate::SocketClient#event] signal, wait for it to be
    /// emitted with [`SocketClientEvent::TlsHandshaking`][crate::SocketClientEvent::TlsHandshaking], and use that to
    /// connect to [`accept-certificate`][struct@crate::TlsConnection#accept-certificate].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `type`
    ///  Readable | Writeable | Construct
    ///
    /// ## Signals
    ///
    ///
    /// #### `event`
    ///  Emitted when `client`'s activity on `connectable` changes state.
    /// Among other things, this can be used to provide progress
    /// information about a network connection in the UI. The meanings of
    /// the different `event` values are as follows:
    ///
    /// - [`SocketClientEvent::Resolving`][crate::SocketClientEvent::Resolving]: `client` is about to look up `connectable`
    ///  in DNS. `connection` will be [`None`].
    ///
    /// - [`SocketClientEvent::Resolved`][crate::SocketClientEvent::Resolved]: `client` has successfully resolved
    ///  `connectable` in DNS. `connection` will be [`None`].
    ///
    /// - [`SocketClientEvent::Connecting`][crate::SocketClientEvent::Connecting]: `client` is about to make a connection
    ///  to a remote host; either a proxy server or the destination server
    ///  itself. `connection` is the [`SocketConnection`][crate::SocketConnection], which is not yet
    ///  connected. Since GLib 2.40, you can access the remote
    ///  address via [`SocketConnectionExt::remote_address()`][crate::prelude::SocketConnectionExt::remote_address()].
    ///
    /// - [`SocketClientEvent::Connected`][crate::SocketClientEvent::Connected]: `client` has successfully connected
    ///  to a remote host. `connection` is the connected [`SocketConnection`][crate::SocketConnection].
    ///
    /// - [`SocketClientEvent::ProxyNegotiating`][crate::SocketClientEvent::ProxyNegotiating]: `client` is about to negotiate
    ///  with a proxy to get it to connect to `connectable`. `connection` is
    ///  the [`SocketConnection`][crate::SocketConnection] to the proxy server.
    ///
    /// - [`SocketClientEvent::ProxyNegotiated`][crate::SocketClientEvent::ProxyNegotiated]: `client` has negotiated a
    ///  connection to `connectable` through a proxy server. `connection` is
    ///  the stream returned from [`ProxyExt::connect()`][crate::prelude::ProxyExt::connect()], which may or may not
    ///  be a [`SocketConnection`][crate::SocketConnection].
    ///
    /// - [`SocketClientEvent::TlsHandshaking`][crate::SocketClientEvent::TlsHandshaking]: `client` is about to begin a TLS
    ///  handshake. `connection` is a [`TlsClientConnection`][crate::TlsClientConnection].
    ///
    /// - [`SocketClientEvent::TlsHandshaked`][crate::SocketClientEvent::TlsHandshaked]: `client` has successfully completed
    ///  the TLS handshake. `connection` is a [`TlsClientConnection`][crate::TlsClientConnection].
    ///
    /// - [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete]: `client` has either successfully connected
    ///  to `connectable` (in which case `connection` is the [`SocketConnection`][crate::SocketConnection]
    ///  that it will be returning to the caller) or has failed (in which
    ///  case `connection` is [`None`] and the client is about to return an error).
    ///
    /// Each event except [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete] may be emitted
    /// multiple times (or not at all) for a given connectable (in
    /// particular, if `client` ends up attempting to connect to more than
    /// one address). However, if `client` emits the [`event`][struct@crate::SocketClient#event]
    /// signal at all for a given connectable, then it will always emit
    /// it with [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete] when it is done.
    ///
    /// Note that there may be additional [`SocketClientEvent`][crate::SocketClientEvent] values in
    /// the future; unrecognized `event` values should be ignored.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`SocketClientExt`][trait@crate::prelude::SocketClientExt], [`trait@glib::ObjectExt`]
    #[doc(alias = "GSocketClient")]
    pub struct SocketClient(Object<ffi::GSocketClient, ffi::GSocketClientClass>);

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

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

    /// Creates a new [`SocketClient`][crate::SocketClient] with the default options.
    ///
    /// # Returns
    ///
    /// a [`SocketClient`][crate::SocketClient].
    ///  Free the returned object with `g_object_unref()`.
    #[doc(alias = "g_socket_client_new")]
    pub fn new() -> SocketClient {
        unsafe { from_glib_full(ffi::g_socket_client_new()) }
    }
}

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

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

/// Trait containing all [`struct@SocketClient`] methods.
///
/// # Implementors
///
/// [`SocketClient`][struct@crate::SocketClient]
pub trait SocketClientExt: IsA<SocketClient> + sealed::Sealed + 'static {
    /// Enable proxy protocols to be handled by the application. When the
    /// indicated proxy protocol is returned by the [`ProxyResolver`][crate::ProxyResolver],
    /// [`SocketClient`][crate::SocketClient] will consider this protocol as supported but will
    /// not try to find a [`Proxy`][crate::Proxy] instance to handle handshaking. The
    /// application must check for this case by calling
    /// [`SocketConnectionExt::remote_address()`][crate::prelude::SocketConnectionExt::remote_address()] on the returned
    /// [`SocketConnection`][crate::SocketConnection], and seeing if it's a [`ProxyAddress`][crate::ProxyAddress] of the
    /// appropriate type, to determine whether or not it needs to handle
    /// the proxy handshaking itself.
    ///
    /// This should be used for proxy protocols that are dialects of
    /// another protocol such as HTTP proxy. It also allows cohabitation of
    /// proxy protocols that are reused between protocols. A good example
    /// is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
    /// be use as generic socket proxy through the HTTP CONNECT method.
    ///
    /// When the proxy is detected as being an application proxy, TLS handshake
    /// will be skipped. This is required to let the application do the proxy
    /// specific handshake.
    /// ## `protocol`
    /// The proxy protocol
    #[doc(alias = "g_socket_client_add_application_proxy")]
    fn add_application_proxy(&self, protocol: &str) {
        unsafe {
            ffi::g_socket_client_add_application_proxy(
                self.as_ref().to_glib_none().0,
                protocol.to_glib_none().0,
            );
        }
    }

    /// Tries to resolve the `connectable` and make a network connection to it.
    ///
    /// Upon a successful connection, a new [`SocketConnection`][crate::SocketConnection] is constructed
    /// and returned. The caller owns this new object and must drop their
    /// reference to it when finished with it.
    ///
    /// The type of the [`SocketConnection`][crate::SocketConnection] object returned depends on the type of
    /// the underlying socket that is used. For instance, for a TCP/IP connection
    /// it will be a [`TcpConnection`][crate::TcpConnection].
    ///
    /// The socket created will be the same family as the address that the
    /// `connectable` resolves to, unless family is set with [`set_family()`][Self::set_family()]
    /// or indirectly via [`set_local_address()`][Self::set_local_address()]. The socket type
    /// defaults to [`SocketType::Stream`][crate::SocketType::Stream] but can be set with
    /// [`set_socket_type()`][Self::set_socket_type()].
    ///
    /// If a local address is specified with [`set_local_address()`][Self::set_local_address()] the
    /// socket will be bound to this address before connecting.
    /// ## `connectable`
    /// a [`SocketConnectable`][crate::SocketConnectable] specifying the remote address.
    /// ## `cancellable`
    /// optional [`Cancellable`][crate::Cancellable] object, [`None`] to ignore.
    ///
    /// # Returns
    ///
    /// a [`SocketConnection`][crate::SocketConnection] on success, [`None`] on error.
    #[doc(alias = "g_socket_client_connect")]
    fn connect(
        &self,
        connectable: &impl IsA<SocketConnectable>,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<SocketConnection, glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect(
                self.as_ref().to_glib_none().0,
                connectable.as_ref().to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// This is the asynchronous version of [`connect()`][Self::connect()].
    ///
    /// You may wish to prefer the asynchronous version even in synchronous
    /// command line programs because, since 2.60, it implements
    /// [RFC 8305](https://tools.ietf.org/html/rfc8305) "Happy Eyeballs"
    /// recommendations to work around long connection timeouts in networks
    /// where IPv6 is broken by performing an IPv4 connection simultaneously
    /// without waiting for IPv6 to time out, which is not supported by the
    /// synchronous call. (This is not an API guarantee, and may change in
    /// the future.)
    ///
    /// When the operation is finished `callback` will be
    /// called. You can then call `g_socket_client_connect_finish()` to get
    /// the result of the operation.
    /// ## `connectable`
    /// a [`SocketConnectable`][crate::SocketConnectable] specifying the remote address.
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    /// ## `callback`
    /// a `GAsyncReadyCallback`
    #[doc(alias = "g_socket_client_connect_async")]
    fn connect_async<P: FnOnce(Result<SocketConnection, glib::Error>) + 'static>(
        &self,
        connectable: &impl IsA<SocketConnectable>,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> =
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn connect_async_trampoline<
            P: FnOnce(Result<SocketConnection, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let ret =
                ffi::g_socket_client_connect_finish(_source_object as *mut _, res, &mut error);
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> =
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = connect_async_trampoline::<P>;
        unsafe {
            ffi::g_socket_client_connect_async(
                self.as_ref().to_glib_none().0,
                connectable.as_ref().to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn connect_future(
        &self,
        connectable: &(impl IsA<SocketConnectable> + Clone + 'static),
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<SocketConnection, glib::Error>> + 'static>>
    {
        let connectable = connectable.clone();
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.connect_async(&connectable, Some(cancellable), move |res| {
                    send.resolve(res);
                });
            },
        ))
    }

    /// This is a helper function for [`connect()`][Self::connect()].
    ///
    /// Attempts to create a TCP connection to the named host.
    ///
    /// `host_and_port` may be in any of a number of recognized formats; an IPv6
    /// address, an IPv4 address, or a domain name (in which case a DNS
    /// lookup is performed). Quoting with [] is supported for all address
    /// types. A port override may be specified in the usual way with a
    /// colon. Ports may be given as decimal numbers or symbolic names (in
    /// which case an /etc/services lookup is performed).
    ///
    /// If no port override is given in `host_and_port` then `default_port` will be
    /// used as the port number to connect to.
    ///
    /// In general, `host_and_port` is expected to be provided by the user (allowing
    /// them to give the hostname, and a port override if necessary) and
    /// `default_port` is expected to be provided by the application.
    ///
    /// In the case that an IP address is given, a single connection
    /// attempt is made. In the case that a name is given, multiple
    /// connection attempts may be made, in turn and according to the
    /// number of address records in DNS, until a connection succeeds.
    ///
    /// Upon a successful connection, a new [`SocketConnection`][crate::SocketConnection] is constructed
    /// and returned. The caller owns this new object and must drop their
    /// reference to it when finished with it.
    ///
    /// In the event of any failure (DNS error, service not found, no hosts
    /// connectable) [`None`] is returned and `error` (if non-[`None`]) is set
    /// accordingly.
    /// ## `host_and_port`
    /// the name and optionally port of the host to connect to
    /// ## `default_port`
    /// the default port to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    ///
    /// # Returns
    ///
    /// a [`SocketConnection`][crate::SocketConnection] on success, [`None`] on error.
    #[doc(alias = "g_socket_client_connect_to_host")]
    fn connect_to_host(
        &self,
        host_and_port: &str,
        default_port: u16,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<SocketConnection, glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_host(
                self.as_ref().to_glib_none().0,
                host_and_port.to_glib_none().0,
                default_port,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// This is the asynchronous version of [`connect_to_host()`][Self::connect_to_host()].
    ///
    /// When the operation is finished `callback` will be
    /// called. You can then call `g_socket_client_connect_to_host_finish()` to get
    /// the result of the operation.
    /// ## `host_and_port`
    /// the name and optionally the port of the host to connect to
    /// ## `default_port`
    /// the default port to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    /// ## `callback`
    /// a `GAsyncReadyCallback`
    #[doc(alias = "g_socket_client_connect_to_host_async")]
    fn connect_to_host_async<P: FnOnce(Result<SocketConnection, glib::Error>) + 'static>(
        &self,
        host_and_port: &str,
        default_port: u16,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> =
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn connect_to_host_async_trampoline<
            P: FnOnce(Result<SocketConnection, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_host_finish(
                _source_object as *mut _,
                res,
                &mut error,
            );
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> =
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = connect_to_host_async_trampoline::<P>;
        unsafe {
            ffi::g_socket_client_connect_to_host_async(
                self.as_ref().to_glib_none().0,
                host_and_port.to_glib_none().0,
                default_port,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn connect_to_host_future(
        &self,
        host_and_port: &str,
        default_port: u16,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<SocketConnection, glib::Error>> + 'static>>
    {
        let host_and_port = String::from(host_and_port);
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.connect_to_host_async(
                    &host_and_port,
                    default_port,
                    Some(cancellable),
                    move |res| {
                        send.resolve(res);
                    },
                );
            },
        ))
    }

    /// Attempts to create a TCP connection to a service.
    ///
    /// This call looks up the SRV record for `service` at `domain` for the
    /// "tcp" protocol. It then attempts to connect, in turn, to each of
    /// the hosts providing the service until either a connection succeeds
    /// or there are no hosts remaining.
    ///
    /// Upon a successful connection, a new [`SocketConnection`][crate::SocketConnection] is constructed
    /// and returned. The caller owns this new object and must drop their
    /// reference to it when finished with it.
    ///
    /// In the event of any failure (DNS error, service not found, no hosts
    /// connectable) [`None`] is returned and `error` (if non-[`None`]) is set
    /// accordingly.
    /// ## `domain`
    /// a domain name
    /// ## `service`
    /// the name of the service to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    ///
    /// # Returns
    ///
    /// a [`SocketConnection`][crate::SocketConnection] if successful, or [`None`] on error
    #[doc(alias = "g_socket_client_connect_to_service")]
    fn connect_to_service(
        &self,
        domain: &str,
        service: &str,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<SocketConnection, glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_service(
                self.as_ref().to_glib_none().0,
                domain.to_glib_none().0,
                service.to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// This is the asynchronous version of
    /// [`connect_to_service()`][Self::connect_to_service()].
    /// ## `domain`
    /// a domain name
    /// ## `service`
    /// the name of the service to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    /// ## `callback`
    /// a `GAsyncReadyCallback`
    #[doc(alias = "g_socket_client_connect_to_service_async")]
    fn connect_to_service_async<P: FnOnce(Result<SocketConnection, glib::Error>) + 'static>(
        &self,
        domain: &str,
        service: &str,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> =
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn connect_to_service_async_trampoline<
            P: FnOnce(Result<SocketConnection, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_service_finish(
                _source_object as *mut _,
                res,
                &mut error,
            );
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> =
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = connect_to_service_async_trampoline::<P>;
        unsafe {
            ffi::g_socket_client_connect_to_service_async(
                self.as_ref().to_glib_none().0,
                domain.to_glib_none().0,
                service.to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn connect_to_service_future(
        &self,
        domain: &str,
        service: &str,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<SocketConnection, glib::Error>> + 'static>>
    {
        let domain = String::from(domain);
        let service = String::from(service);
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.connect_to_service_async(&domain, &service, Some(cancellable), move |res| {
                    send.resolve(res);
                });
            },
        ))
    }

    /// This is a helper function for [`connect()`][Self::connect()].
    ///
    /// Attempts to create a TCP connection with a network URI.
    ///
    /// `uri` may be any valid URI containing an "authority" (hostname/port)
    /// component. If a port is not specified in the URI, `default_port`
    /// will be used. TLS will be negotiated if [`tls`][struct@crate::SocketClient#tls] is [`true`].
    /// ([`SocketClient`][crate::SocketClient] does not know to automatically assume TLS for
    /// certain URI schemes.)
    ///
    /// Using this rather than [`connect()`][Self::connect()] or
    /// [`connect_to_host()`][Self::connect_to_host()] allows [`SocketClient`][crate::SocketClient] to
    /// determine when to use application-specific proxy protocols.
    ///
    /// Upon a successful connection, a new [`SocketConnection`][crate::SocketConnection] is constructed
    /// and returned. The caller owns this new object and must drop their
    /// reference to it when finished with it.
    ///
    /// In the event of any failure (DNS error, service not found, no hosts
    /// connectable) [`None`] is returned and `error` (if non-[`None`]) is set
    /// accordingly.
    /// ## `uri`
    /// A network URI
    /// ## `default_port`
    /// the default port to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    ///
    /// # Returns
    ///
    /// a [`SocketConnection`][crate::SocketConnection] on success, [`None`] on error.
    #[doc(alias = "g_socket_client_connect_to_uri")]
    fn connect_to_uri(
        &self,
        uri: &str,
        default_port: u16,
        cancellable: Option<&impl IsA<Cancellable>>,
    ) -> Result<SocketConnection, glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_uri(
                self.as_ref().to_glib_none().0,
                uri.to_glib_none().0,
                default_port,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// This is the asynchronous version of [`connect_to_uri()`][Self::connect_to_uri()].
    ///
    /// When the operation is finished `callback` will be
    /// called. You can then call `g_socket_client_connect_to_uri_finish()` to get
    /// the result of the operation.
    /// ## `uri`
    /// a network uri
    /// ## `default_port`
    /// the default port to connect to
    /// ## `cancellable`
    /// a [`Cancellable`][crate::Cancellable], or [`None`]
    /// ## `callback`
    /// a `GAsyncReadyCallback`
    #[doc(alias = "g_socket_client_connect_to_uri_async")]
    fn connect_to_uri_async<P: FnOnce(Result<SocketConnection, glib::Error>) + 'static>(
        &self,
        uri: &str,
        default_port: u16,
        cancellable: Option<&impl IsA<Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> =
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn connect_to_uri_async_trampoline<
            P: FnOnce(Result<SocketConnection, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut crate::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = ptr::null_mut();
            let ret = ffi::g_socket_client_connect_to_uri_finish(
                _source_object as *mut _,
                res,
                &mut error,
            );
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> =
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = connect_to_uri_async_trampoline::<P>;
        unsafe {
            ffi::g_socket_client_connect_to_uri_async(
                self.as_ref().to_glib_none().0,
                uri.to_glib_none().0,
                default_port,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }

    fn connect_to_uri_future(
        &self,
        uri: &str,
        default_port: u16,
    ) -> Pin<Box_<dyn std::future::Future<Output = Result<SocketConnection, glib::Error>> + 'static>>
    {
        let uri = String::from(uri);
        Box_::pin(crate::GioFuture::new(
            self,
            move |obj, cancellable, send| {
                obj.connect_to_uri_async(&uri, default_port, Some(cancellable), move |res| {
                    send.resolve(res);
                });
            },
        ))
    }

    /// Gets the proxy enable state; see [`set_enable_proxy()`][Self::set_enable_proxy()]
    ///
    /// # Returns
    ///
    /// whether proxying is enabled
    #[doc(alias = "g_socket_client_get_enable_proxy")]
    #[doc(alias = "get_enable_proxy")]
    fn enables_proxy(&self) -> bool {
        unsafe {
            from_glib(ffi::g_socket_client_get_enable_proxy(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the socket family of the socket client.
    ///
    /// See [`set_family()`][Self::set_family()] for details.
    ///
    /// # Returns
    ///
    /// a [`SocketFamily`][crate::SocketFamily]
    #[doc(alias = "g_socket_client_get_family")]
    #[doc(alias = "get_family")]
    fn family(&self) -> SocketFamily {
        unsafe {
            from_glib(ffi::g_socket_client_get_family(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the local address of the socket client.
    ///
    /// See [`set_local_address()`][Self::set_local_address()] for details.
    ///
    /// # Returns
    ///
    /// a [`SocketAddress`][crate::SocketAddress] or [`None`]. Do not free.
    #[doc(alias = "g_socket_client_get_local_address")]
    #[doc(alias = "get_local_address")]
    fn local_address(&self) -> Option<SocketAddress> {
        unsafe {
            from_glib_none(ffi::g_socket_client_get_local_address(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the protocol name type of the socket client.
    ///
    /// See [`set_protocol()`][Self::set_protocol()] for details.
    ///
    /// # Returns
    ///
    /// a [`SocketProtocol`][crate::SocketProtocol]
    #[doc(alias = "g_socket_client_get_protocol")]
    #[doc(alias = "get_protocol")]
    fn protocol(&self) -> SocketProtocol {
        unsafe {
            from_glib(ffi::g_socket_client_get_protocol(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the [`ProxyResolver`][crate::ProxyResolver] being used by `self`. Normally, this will
    /// be the resolver returned by [`ProxyResolver::default()`][crate::ProxyResolver::default()], but you
    /// can override it with [`set_proxy_resolver()`][Self::set_proxy_resolver()].
    ///
    /// # Returns
    ///
    /// The [`ProxyResolver`][crate::ProxyResolver] being used by
    ///  `self`.
    #[doc(alias = "g_socket_client_get_proxy_resolver")]
    #[doc(alias = "get_proxy_resolver")]
    fn proxy_resolver(&self) -> ProxyResolver {
        unsafe {
            from_glib_none(ffi::g_socket_client_get_proxy_resolver(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the socket type of the socket client.
    ///
    /// See [`set_socket_type()`][Self::set_socket_type()] for details.
    ///
    /// # Returns
    ///
    /// a [`SocketFamily`][crate::SocketFamily]
    #[doc(alias = "g_socket_client_get_socket_type")]
    #[doc(alias = "get_socket_type")]
    fn socket_type(&self) -> SocketType {
        unsafe {
            from_glib(ffi::g_socket_client_get_socket_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the I/O timeout time for sockets created by `self`.
    ///
    /// See [`set_timeout()`][Self::set_timeout()] for details.
    ///
    /// # Returns
    ///
    /// the timeout in seconds
    #[doc(alias = "g_socket_client_get_timeout")]
    #[doc(alias = "get_timeout")]
    fn timeout(&self) -> u32 {
        unsafe { ffi::g_socket_client_get_timeout(self.as_ref().to_glib_none().0) }
    }

    /// Gets whether `self` creates TLS connections. See
    /// [`set_tls()`][Self::set_tls()] for details.
    ///
    /// # Returns
    ///
    /// whether `self` uses TLS
    #[doc(alias = "g_socket_client_get_tls")]
    #[doc(alias = "get_tls")]
    fn is_tls(&self) -> bool {
        unsafe { from_glib(ffi::g_socket_client_get_tls(self.as_ref().to_glib_none().0)) }
    }

    /// Gets the TLS validation flags used creating TLS connections via
    /// `self`.
    ///
    /// This function does not work as originally designed and is impossible
    /// to use correctly. See [`tls-validation-flags`][struct@crate::SocketClient#tls-validation-flags] for more
    /// information.
    ///
    /// # Deprecated since 2.72
    ///
    /// Do not attempt to ignore validation errors.
    ///
    /// # Returns
    ///
    /// the TLS validation flags
    #[cfg_attr(feature = "v2_72", deprecated = "Since 2.72")]
    #[allow(deprecated)]
    #[doc(alias = "g_socket_client_get_tls_validation_flags")]
    #[doc(alias = "get_tls_validation_flags")]
    fn tls_validation_flags(&self) -> TlsCertificateFlags {
        unsafe {
            from_glib(ffi::g_socket_client_get_tls_validation_flags(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Sets whether or not `self` attempts to make connections via a
    /// proxy server. When enabled (the default), [`SocketClient`][crate::SocketClient] will use a
    /// [`ProxyResolver`][crate::ProxyResolver] to determine if a proxy protocol such as SOCKS is
    /// needed, and automatically do the necessary proxy negotiation.
    ///
    /// See also [`set_proxy_resolver()`][Self::set_proxy_resolver()].
    /// ## `enable`
    /// whether to enable proxies
    #[doc(alias = "g_socket_client_set_enable_proxy")]
    fn set_enable_proxy(&self, enable: bool) {
        unsafe {
            ffi::g_socket_client_set_enable_proxy(
                self.as_ref().to_glib_none().0,
                enable.into_glib(),
            );
        }
    }

    /// Sets the socket family of the socket client.
    /// If this is set to something other than [`SocketFamily::Invalid`][crate::SocketFamily::Invalid]
    /// then the sockets created by this object will be of the specified
    /// family.
    ///
    /// This might be useful for instance if you want to force the local
    /// connection to be an ipv4 socket, even though the address might
    /// be an ipv6 mapped to ipv4 address.
    /// ## `family`
    /// a [`SocketFamily`][crate::SocketFamily]
    #[doc(alias = "g_socket_client_set_family")]
    fn set_family(&self, family: SocketFamily) {
        unsafe {
            ffi::g_socket_client_set_family(self.as_ref().to_glib_none().0, family.into_glib());
        }
    }

    /// Sets the local address of the socket client.
    /// The sockets created by this object will bound to the
    /// specified address (if not [`None`]) before connecting.
    ///
    /// This is useful if you want to ensure that the local
    /// side of the connection is on a specific port, or on
    /// a specific interface.
    /// ## `address`
    /// a [`SocketAddress`][crate::SocketAddress], or [`None`]
    #[doc(alias = "g_socket_client_set_local_address")]
    fn set_local_address(&self, address: Option<&impl IsA<SocketAddress>>) {
        unsafe {
            ffi::g_socket_client_set_local_address(
                self.as_ref().to_glib_none().0,
                address.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Sets the protocol of the socket client.
    /// The sockets created by this object will use of the specified
    /// protocol.
    ///
    /// If `protocol` is [`SocketProtocol::Default`][crate::SocketProtocol::Default] that means to use the default
    /// protocol for the socket family and type.
    /// ## `protocol`
    /// a [`SocketProtocol`][crate::SocketProtocol]
    #[doc(alias = "g_socket_client_set_protocol")]
    fn set_protocol(&self, protocol: SocketProtocol) {
        unsafe {
            ffi::g_socket_client_set_protocol(self.as_ref().to_glib_none().0, protocol.into_glib());
        }
    }

    /// Overrides the [`ProxyResolver`][crate::ProxyResolver] used by `self`. You can call this if
    /// you want to use specific proxies, rather than using the system
    /// default proxy settings.
    ///
    /// Note that whether or not the proxy resolver is actually used
    /// depends on the setting of [`enable-proxy`][struct@crate::SocketClient#enable-proxy], which is not
    /// changed by this function (but which is [`true`] by default)
    /// ## `proxy_resolver`
    /// a [`ProxyResolver`][crate::ProxyResolver], or [`None`] for the
    ///  default.
    #[doc(alias = "g_socket_client_set_proxy_resolver")]
    fn set_proxy_resolver(&self, proxy_resolver: Option<&impl IsA<ProxyResolver>>) {
        unsafe {
            ffi::g_socket_client_set_proxy_resolver(
                self.as_ref().to_glib_none().0,
                proxy_resolver.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Sets the socket type of the socket client.
    /// The sockets created by this object will be of the specified
    /// type.
    ///
    /// It doesn't make sense to specify a type of [`SocketType::Datagram`][crate::SocketType::Datagram],
    /// as GSocketClient is used for connection oriented services.
    /// ## `type_`
    /// a [`SocketType`][crate::SocketType]
    #[doc(alias = "g_socket_client_set_socket_type")]
    fn set_socket_type(&self, type_: SocketType) {
        unsafe {
            ffi::g_socket_client_set_socket_type(self.as_ref().to_glib_none().0, type_.into_glib());
        }
    }

    /// Sets the I/O timeout for sockets created by `self`. `timeout` is a
    /// time in seconds, or 0 for no timeout (the default).
    ///
    /// The timeout value affects the initial connection attempt as well,
    /// so setting this may cause calls to [`connect()`][Self::connect()], etc,
    /// to fail with [`IOErrorEnum::TimedOut`][crate::IOErrorEnum::TimedOut].
    /// ## `timeout`
    /// the timeout
    #[doc(alias = "g_socket_client_set_timeout")]
    fn set_timeout(&self, timeout: u32) {
        unsafe {
            ffi::g_socket_client_set_timeout(self.as_ref().to_glib_none().0, timeout);
        }
    }

    /// Sets whether `self` creates TLS (aka SSL) connections. If `tls` is
    /// [`true`], `self` will wrap its connections in a [`TlsClientConnection`][crate::TlsClientConnection]
    /// and perform a TLS handshake when connecting.
    ///
    /// Note that since [`SocketClient`][crate::SocketClient] must return a [`SocketConnection`][crate::SocketConnection],
    /// but [`TlsClientConnection`][crate::TlsClientConnection] is not a [`SocketConnection`][crate::SocketConnection], this
    /// actually wraps the resulting [`TlsClientConnection`][crate::TlsClientConnection] in a
    /// `GTcpWrapperConnection` when returning it. You can use
    /// `g_tcp_wrapper_connection_get_base_io_stream()` on the return value
    /// to extract the [`TlsClientConnection`][crate::TlsClientConnection].
    ///
    /// If you need to modify the behavior of the TLS handshake (eg, by
    /// setting a client-side certificate to use, or connecting to the
    /// [`accept-certificate`][struct@crate::TlsConnection#accept-certificate] signal), you can connect to
    /// `self`'s [`event`][struct@crate::SocketClient#event] signal and wait for it to be
    /// emitted with [`SocketClientEvent::TlsHandshaking`][crate::SocketClientEvent::TlsHandshaking], which will give you
    /// a chance to see the [`TlsClientConnection`][crate::TlsClientConnection] before the handshake
    /// starts.
    /// ## `tls`
    /// whether to use TLS
    #[doc(alias = "g_socket_client_set_tls")]
    fn set_tls(&self, tls: bool) {
        unsafe {
            ffi::g_socket_client_set_tls(self.as_ref().to_glib_none().0, tls.into_glib());
        }
    }

    /// Sets the TLS validation flags used when creating TLS connections
    /// via `self`. The default value is [`TlsCertificateFlags::VALIDATE_ALL`][crate::TlsCertificateFlags::VALIDATE_ALL].
    ///
    /// This function does not work as originally designed and is impossible
    /// to use correctly. See [`tls-validation-flags`][struct@crate::SocketClient#tls-validation-flags] for more
    /// information.
    ///
    /// # Deprecated since 2.72
    ///
    /// Do not attempt to ignore validation errors.
    /// ## `flags`
    /// the validation flags
    #[cfg_attr(feature = "v2_72", deprecated = "Since 2.72")]
    #[allow(deprecated)]
    #[doc(alias = "g_socket_client_set_tls_validation_flags")]
    fn set_tls_validation_flags(&self, flags: TlsCertificateFlags) {
        unsafe {
            ffi::g_socket_client_set_tls_validation_flags(
                self.as_ref().to_glib_none().0,
                flags.into_glib(),
            );
        }
    }

    #[doc(alias = "type")]
    fn type_(&self) -> SocketType {
        ObjectExt::property(self.as_ref(), "type")
    }

    #[doc(alias = "type")]
    fn set_type(&self, type_: SocketType) {
        ObjectExt::set_property(self.as_ref(), "type", type_)
    }

    /// Emitted when `client`'s activity on `connectable` changes state.
    /// Among other things, this can be used to provide progress
    /// information about a network connection in the UI. The meanings of
    /// the different `event` values are as follows:
    ///
    /// - [`SocketClientEvent::Resolving`][crate::SocketClientEvent::Resolving]: `client` is about to look up `connectable`
    ///  in DNS. `connection` will be [`None`].
    ///
    /// - [`SocketClientEvent::Resolved`][crate::SocketClientEvent::Resolved]: `client` has successfully resolved
    ///  `connectable` in DNS. `connection` will be [`None`].
    ///
    /// - [`SocketClientEvent::Connecting`][crate::SocketClientEvent::Connecting]: `client` is about to make a connection
    ///  to a remote host; either a proxy server or the destination server
    ///  itself. `connection` is the [`SocketConnection`][crate::SocketConnection], which is not yet
    ///  connected. Since GLib 2.40, you can access the remote
    ///  address via [`SocketConnectionExt::remote_address()`][crate::prelude::SocketConnectionExt::remote_address()].
    ///
    /// - [`SocketClientEvent::Connected`][crate::SocketClientEvent::Connected]: `client` has successfully connected
    ///  to a remote host. `connection` is the connected [`SocketConnection`][crate::SocketConnection].
    ///
    /// - [`SocketClientEvent::ProxyNegotiating`][crate::SocketClientEvent::ProxyNegotiating]: `client` is about to negotiate
    ///  with a proxy to get it to connect to `connectable`. `connection` is
    ///  the [`SocketConnection`][crate::SocketConnection] to the proxy server.
    ///
    /// - [`SocketClientEvent::ProxyNegotiated`][crate::SocketClientEvent::ProxyNegotiated]: `client` has negotiated a
    ///  connection to `connectable` through a proxy server. `connection` is
    ///  the stream returned from [`ProxyExt::connect()`][crate::prelude::ProxyExt::connect()], which may or may not
    ///  be a [`SocketConnection`][crate::SocketConnection].
    ///
    /// - [`SocketClientEvent::TlsHandshaking`][crate::SocketClientEvent::TlsHandshaking]: `client` is about to begin a TLS
    ///  handshake. `connection` is a [`TlsClientConnection`][crate::TlsClientConnection].
    ///
    /// - [`SocketClientEvent::TlsHandshaked`][crate::SocketClientEvent::TlsHandshaked]: `client` has successfully completed
    ///  the TLS handshake. `connection` is a [`TlsClientConnection`][crate::TlsClientConnection].
    ///
    /// - [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete]: `client` has either successfully connected
    ///  to `connectable` (in which case `connection` is the [`SocketConnection`][crate::SocketConnection]
    ///  that it will be returning to the caller) or has failed (in which
    ///  case `connection` is [`None`] and the client is about to return an error).
    ///
    /// Each event except [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete] may be emitted
    /// multiple times (or not at all) for a given connectable (in
    /// particular, if `client` ends up attempting to connect to more than
    /// one address). However, if `client` emits the [`event`][struct@crate::SocketClient#event]
    /// signal at all for a given connectable, then it will always emit
    /// it with [`SocketClientEvent::Complete`][crate::SocketClientEvent::Complete] when it is done.
    ///
    /// Note that there may be additional [`SocketClientEvent`][crate::SocketClientEvent] values in
    /// the future; unrecognized `event` values should be ignored.
    /// ## `event`
    /// the event that is occurring
    /// ## `connectable`
    /// the [`SocketConnectable`][crate::SocketConnectable] that `event` is occurring on
    /// ## `connection`
    /// the current representation of the connection
    #[doc(alias = "event")]
    fn connect_event<
        F: Fn(&Self, SocketClientEvent, &SocketConnectable, Option<&IOStream>) + 'static,
    >(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn event_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P, SocketClientEvent, &SocketConnectable, Option<&IOStream>) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            event: ffi::GSocketClientEvent,
            connectable: *mut ffi::GSocketConnectable,
            connection: *mut ffi::GIOStream,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                SocketClient::from_glib_borrow(this).unsafe_cast_ref(),
                from_glib(event),
                &from_glib_borrow(connectable),
                Option::<IOStream>::from_glib_borrow(connection)
                    .as_ref()
                    .as_ref(),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"event\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    event_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "enable-proxy")]
    fn connect_enable_proxy_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_enable_proxy_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::enable-proxy\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_enable_proxy_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "family")]
    fn connect_family_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_family_trampoline<P: IsA<SocketClient>, F: Fn(&P) + 'static>(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::family\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_family_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "local-address")]
    fn connect_local_address_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_local_address_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::local-address\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_local_address_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "protocol")]
    fn connect_protocol_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_protocol_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::protocol\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_protocol_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "proxy-resolver")]
    fn connect_proxy_resolver_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_proxy_resolver_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::proxy-resolver\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_proxy_resolver_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "timeout")]
    fn connect_timeout_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_timeout_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::timeout\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_timeout_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "tls")]
    fn connect_tls_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_tls_trampoline<P: IsA<SocketClient>, F: Fn(&P) + 'static>(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::tls\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_tls_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg_attr(feature = "v2_72", deprecated = "Since 2.72")]
    #[doc(alias = "tls-validation-flags")]
    fn connect_tls_validation_flags_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_tls_validation_flags_trampoline<
            P: IsA<SocketClient>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::tls-validation-flags\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_tls_validation_flags_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "type")]
    fn connect_type_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_type_trampoline<P: IsA<SocketClient>, F: Fn(&P) + 'static>(
            this: *mut ffi::GSocketClient,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(SocketClient::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::type\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_type_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<SocketClient>> SocketClientExt for O {}

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