Add Stream (Advanced) bindings

Author: swift-developer-tools-archive

Sources/SwiftLibgit2/Stream-Advanced/Stream-Advanced-Callbacks.swift

@@ -0,0 +1,34 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the swift-libgit2 open source project.
+//
+// Copyright (c) Margins Technologies LLC.
+// Licensed under the Apache License, Version 2.0.
+//
+//===----------------------------------------------------------------------===//
+
+import CLibgit2
+
+
+
+/// The callback invoked to create a new connection to the given host and port.
+/// - Parameters:
+///   - out: The pointer in which to store the stream.
+///   - host: The name of the host to which to connect the stream.
+///   - port: The port to which to connect the stream.
+/// - Returns: `0` on success, or an error code.
+///
+/// ## Discussion
+///
+/// - Warning: This is deprecated in libgit2 and will be removed in the next
+/// major release. Use ``GitStreamRegistration/Initialize`` instead.
+///
+/// ## C Equivalent
+///
+/// [`git_stream_cb()`](https://libgit2.org/docs/reference/main/sys/stream/git_stream_cb.html)
+public typealias GitStreamCB = @convention(c)
+(
+    UnsafeMutablePointer<UnsafeMutablePointer<git_stream>?>?,
+    UnsafePointer<CChar>?,
+    UnsafePointer<CChar>?
+) -> Int32

Sources/SwiftLibgit2/Stream-Advanced/Stream-Advanced-Enums.swift

@@ -0,0 +1,56 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the swift-libgit2 open source project.
+//
+// Copyright (c) Margins Technologies LLC.
+// Licensed under the Apache License, Version 2.0.
+//
+//===----------------------------------------------------------------------===//
+
+import CLibgit2
+
+
+
+/// The type of stream.
+///
+/// ## C Equivalent
+///
+/// [`git_stream_t`](https://libgit2.org/docs/reference/main/sys/stream/git_stream_t.html)
+public enum GitStreamT: UInt32, CEnum
+{
+    /// A standard non-TLS socket.
+    case gitStreamStandard  = 1
+    
+    /// A TLS-encrypted socket.
+    case gitStreamTLS       = 2
+    
+    
+    
+    /// Initializes a ``GitStreamT`` instance from the given  `git_stream_t`
+    /// instance.
+    /// - Parameter stream: The `git_stream_t` instance to use.
+    internal init?(
+        cValue stream: git_stream_t
+    )
+    {
+        switch stream
+        {
+            case GIT_STREAM_STANDARD    : self = .gitStreamStandard
+            case GIT_STREAM_TLS         : self = .gitStreamTLS
+            default                     : return nil
+        }
+    }
+    
+    
+    
+    /// Converts the ``GitStreamT`` instance into a `git_stream_t` instance.
+    /// - Returns: The `git_stream_t` instance.
+    internal func cValue() -> git_stream_t
+    {
+        switch self
+        {
+            case .gitStreamStandard : return GIT_STREAM_STANDARD
+            case .gitStreamTLS      : return GIT_STREAM_TLS
+        }
+    }
+}

Sources/SwiftLibgit2/Stream-Advanced/Stream-Advanced-Functions.swift

@@ -0,0 +1,68 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the swift-libgit2 open source project.
+//
+// Copyright (c) Margins Technologies LLC.
+// Licensed under the Apache License, Version 2.0.
+//
+//===----------------------------------------------------------------------===//
+
+import CLibgit2
+
+
+
+/// Registers the specified stream constructor.
+/// - Parameters:
+///   - type: The type of stream to register.
+///   - registration: The stream registration information to use. Pass `nil`
+///   to unregister the stream and use the system defaults.
+/// - Returns: A ``GitErrorCode`` instance.
+///
+/// ## Discussion
+///
+/// If the specified stream constructor has already been registered, it will
+/// be overwritten.
+///
+/// ## C Equivalent
+///
+/// [`git_stream_register()`](https://libgit2.org/docs/reference/main/sys/stream/git_stream_register.html)
+public func gitStreamRegister(
+    type            : GitStreamT,
+    registration    : UnsafeMutablePointer<git_stream_registration>?
+) -> GitErrorCode
+{
+    return withCConversion
+    {
+        return git_stream_register(
+            type.cValue(),
+            registration
+        )
+    }
+}
+
+
+
+/// Registers a TLS stream constructor.
+/// - Parameter ctor: The ``GitStreamCB`` callback to invoke to create a new
+/// connection. Pass `nil` to unregister the stream and use the system defaults.
+/// - Returns: A ``GitErrorCode`` instance.
+///
+/// ## Discussion
+///
+/// - Note: This function does not support HTTP CONNECT proxies.
+///
+/// - Warning: This is deprecated in libgit2 and will be removed in the next
+/// major release. Use ``GitStreamRegistration/Initialize`` instead.
+///
+/// ## C Equivalent
+///
+/// [`git_stream_register_tls()`](https://libgit2.org/docs/reference/main/sys/stream/git_stream_register_tls.html)
+public func gitStreamRegisterTLS(
+    ctor: GitStreamCB?
+) -> GitErrorCode
+{
+    return withCConversion
+    {
+        return git_stream_register_tls(ctor)
+    }
+}

Sources/SwiftLibgit2/Stream-Advanced/Stream-Advanced-Macros.swift

@@ -0,0 +1,15 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the swift-libgit2 open source project.
+//
+// Copyright (c) Margins Technologies LLC.
+// Licensed under the Apache License, Version 2.0.
+//
+//===----------------------------------------------------------------------===//
+
+/// The current version for ``GitStream``.
+///
+/// ## C Equivalent
+///
+/// [`GIT_STREAM_VERSION`](https://libgit2.org/docs/reference/main/sys/stream/GIT_STREAM_VERSION.html)
+public let gitStreamVersion: Int32 = 1