@swiftbrowser/swift 0.0.0-stage → 0.2.0

package/Sources/Combine/Subscribers/Subscribers.Demand.swift

@@ -0,0 +1,476 @@
+//
+//  Subscribers.Demand.swift
+//  
+//
+//  Created by Sergej Jaskiewicz on 10.06.2019.
+//
+
+// swiftlint:disable attributes
+
+#if canImport(_Concurrency) && compiler(>=5.5)
+import _Concurrency
+#endif
+
+extension Subscribers {
+
+    /// A requested number of items, sent to a publisher from a subscriber through
+    /// the subscription.
+    public struct Demand: Equatable,
+                          Comparable,
+                          Hashable,
+                          Codable,
+                          CustomStringConvertible
+    {
+        @usableFromInline
+        internal let rawValue: UInt
+
+        @inline(__always)
+        @inlinable
+        internal init(rawValue: UInt) {
+            self.rawValue = min(UInt(Int.max) + 1, rawValue)
+        }
+
+        /// A request for as many values as the publisher can produce.
+        @inline(__always)
+        @inlinable
+        public static var unlimited: Demand {
+            return Demand(rawValue: .max)
+        }
+
+        /// A request for no elements from the publisher.
+        ///
+        /// This is equivalent to `Demand.max(0)`.
+        @inline(__always)
+        @inlinable
+        public static var none: Demand { return .max(0) }
+
+        /// Creates a demand for the given maximum number of elements.
+        ///
+        /// The publisher is free to send fewer than the requested maximum number of
+        /// elements.
+        ///
+        /// - Parameter value: The maximum number of elements. Providing a negative value
+        /// for this parameter results in a fatal error.
+        @inline(__always)
+        @inlinable
+        public static func max(_ value: Int) -> Demand {
+            precondition(value >= 0, "demand cannot be negative")
+            return Demand(rawValue: UInt(value))
+        }
+
+        public var description: String {
+            if self == .unlimited {
+                return "unlimited"
+            } else {
+                return "max(\(rawValue))"
+            }
+        }
+
+        /// Returns the result of adding two demands.
+        /// When adding any value to `.unlimited`, the result is `.unlimited`.
+        @inline(__always)
+        @inlinable
+        public static func + (lhs: Demand, rhs: Demand) -> Demand {
+            switch (lhs, rhs) {
+            case (.unlimited, _):
+                return .unlimited
+            case (_, .unlimited):
+                return .unlimited
+            default:
+                let (sum, isOverflow) = Int(lhs.rawValue)
+                    .addingReportingOverflow(Int(rhs.rawValue))
+                return isOverflow ? .unlimited : .max(sum)
+            }
+        }
+
+        /// Adds two demands, and assigns the result to the first demand.
+        /// When adding any value to `.unlimited`, the result is `.unlimited`.
+        @inline(__always)
+        @inlinable
+        public static func += (lhs: inout Demand, rhs: Demand) {
+            if lhs == .unlimited { return }
+            lhs = lhs + rhs
+        }
+
+        /// Returns the result of adding an integer to a demand.
+        /// When adding any value to` .unlimited`, the result is `.unlimited`.
+        @inline(__always)
+        @inlinable
+        public static func + (lhs: Demand, rhs: Int) -> Demand {
+            if lhs == .unlimited {
+                return .unlimited
+            }
+            let (sum, isOverflow) = Int(lhs.rawValue).addingReportingOverflow(rhs)
+            return isOverflow ? .unlimited : .max(sum)
+        }
+
+        /// Adds an integer to a demand, and assigns the result to the demand.
+        /// When adding any value to `.unlimited`, the result is `.unlimited`.
+        @inline(__always)
+        @inlinable
+        public static func += (lhs: inout Demand, rhs: Int) {
+            lhs = lhs + rhs
+        }
+
+        /// Returns the result of multiplying a demand by an integer.
+        /// When multiplying any value by `.unlimited`, the result is `.unlimited`. If
+        /// the multiplication operation overflows, the result is `.unlimited`.
+        public static func * (lhs: Demand, rhs: Int) -> Demand {
+            if lhs == .unlimited {
+                return .unlimited
+            }
+            let (product, isOverflow) = Int(lhs.rawValue)
+                .multipliedReportingOverflow(by: rhs)
+            return isOverflow ? .unlimited : .max(product)
+        }
+
+        /// Multiplies a demand by an integer, and assigns the result to the demand.
+        /// When multiplying any value by `.unlimited`, the result is `.unlimited`. If
+        /// the multiplication operation overflows, the result is `.unlimited`.
+        @inline(__always)
+        @inlinable
+        public static func *= (lhs: inout Demand, rhs: Int) {
+            lhs = lhs * rhs
+        }
+
+        /// Returns the result of subtracting one demand from another.
+        /// When subtracting any value (including `.unlimited`) from `.unlimited`,
+        /// the result is still `.unlimited`. Subtracting `.unlimited` from any value
+        /// (except `.unlimited`) results in `.max(0)`. A negative demand is not possible;
+        /// any operation that would result in a negative value is clamped to `.max(0)`.
+        @inline(__always)
+        @inlinable
+        public static func - (lhs: Demand, rhs: Demand) -> Demand {
+            switch (lhs, rhs) {
+            case (.unlimited, _):
+                return .unlimited
+            case (_, .unlimited):
+                return .none
+            default:
+                let (difference, isOverflow) = Int(lhs.rawValue)
+                    .subtractingReportingOverflow(Int(rhs.rawValue))
+                return isOverflow ? .none : .max(difference)
+            }
+        }
+
+        /// Subtracts one demand from another, and assigns the result to the first demand.
+        /// When subtracting any value (including `.unlimited`) from `.unlimited`,
+        /// the result is still `.unlimited`. Subtracting unlimited from any value
+        /// (except `.unlimited`) results in `.max(0)`. A negative demand is not possible;
+        /// any operation that would result in a negative value is clamped to `.max(0)`.
+        /// but be aware that it is not usable when requesting values in a subscription.
+        @inline(__always)
+        @inlinable
+        public static func -= (lhs: inout Demand, rhs: Demand) {
+            lhs = lhs - rhs
+        }
+
+        /// Returns the result of subtracting an integer from a demand.
+        /// When subtracting any value from `.unlimited`, the result is still
+        /// `.unlimited`.
+        /// A negative demand is not possible; any operation that would result in
+        /// a negative value is clamped to `.max(0)`
+        @inline(__always)
+        @inlinable
+        public static func - (lhs: Demand, rhs: Int) -> Demand {
+            if lhs == .unlimited {
+                return .unlimited
+            }
+
+            let (difference, isOverflow) = Int(lhs.rawValue)
+                .subtractingReportingOverflow(rhs)
+            return isOverflow ? .none : .max(difference)
+        }
+
+        /// Subtracts an integer from a demand, and assigns the result to the demand.
+        /// When subtracting any value from `.unlimited,` the result is still
+        /// `.unlimited`.
+        /// A negative demand is not possible; any operation that would result in
+        /// a negative value is clamped to `.max(0)`
+        @inline(__always)
+        @inlinable
+        public static func -= (lhs: inout Demand, rhs: Int) {
+            if lhs == .unlimited { return }
+            lhs = lhs - rhs
+        }
+
+        /// Returns a Boolean that indicates whether the demand requests more than
+        /// the given number of elements.
+        /// If `lhs` is `.unlimited`, then the result is always `true`.
+        /// Otherwise, the operator compares the demand’s `max` value to `rhs`.
+        @inline(__always)
+        @inlinable
+        public static func > (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return true
+            } else {
+                return Int(lhs.rawValue) > rhs
+            }
+        }
+
+        /// Returns a Boolean that indicates whether the first demand requests more or
+        /// the same number of elements as the second.
+        /// If `lhs` is `.unlimited`, then the result is always `true`.
+        /// Otherwise, the operator compares the demand’s `max` value to `rhs`.
+        @inline(__always)
+        @inlinable
+        public static func >= (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return true
+            } else {
+                return Int(lhs.rawValue) >= rhs
+            }
+        }
+
+        /// Returns a Boolean that indicates a given number of elements is greater than
+        /// the maximum specified by the demand.
+        /// If `rhs` is `.unlimited`, then the result is always `false`.
+        /// Otherwise, the operator compares the demand’s `max` value to `lhs`.
+        @inline(__always)
+        @inlinable
+        public static func > (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return false
+            } else {
+                return lhs > Int(rhs.rawValue)
+            }
+        }
+
+        /// Returns a Boolean that indicates a given number of elements is greater than
+        /// or equal to the maximum specified by the demand.
+        /// If `rhs` is `.unlimited`, then the result is always `false`.
+        /// Otherwise, the operator compares the demand’s `max` value to `lhs`.
+        @inline(__always)
+        @inlinable
+        public static func >= (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return false
+            } else {
+                return lhs >= Int(rhs.rawValue)
+            }
+        }
+
+        /// Returns a Boolean that indicates whether the demand requests fewer than
+        /// the given number of elements.
+        /// If `lhs` is `.unlimited`, then the result is always `false`.
+        /// Otherwise, the operator compares the demand’s `max` value to `rhs`.
+        @inline(__always)
+        @inlinable
+        public static func < (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return false
+            } else {
+                return Int(lhs.rawValue) < rhs
+            }
+        }
+
+        /// Returns a Boolean that indicates a given number of elements is less than
+        /// the maximum specified by the demand.
+        /// If `rhs` is `.unlimited`, then the result is always `true`.
+        /// Otherwise, the operator compares the demand’s `max` value to `lhs`.
+        @inline(__always)
+        @inlinable
+        public static func < (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return true
+            } else {
+                return lhs < Int(rhs.rawValue)
+            }
+        }
+
+        /// Returns a Boolean that indicates whether the demand requests fewer or
+        /// the same number of elements as the given integer.
+        /// If `lhs` is `.unlimited`, then the result is always `false`.
+        /// Otherwise, the operator compares the demand’s `max` value to `rhs`.
+        @inline(__always)
+        @inlinable
+        public static func <= (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return false
+            } else {
+                return Int(lhs.rawValue) <= rhs
+            }
+        }
+
+        /// Returns a Boolean value that indicates a given number of elements is less
+        /// than or equal the maximum specified by the demand.
+        /// If `rhs` is `.unlimited`, then the result is always `true`.
+        /// Otherwise, the operator compares the demand’s `max` value to `lhs`.
+        @inline(__always)
+        @inlinable
+        public static func <= (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return true
+            } else {
+                return lhs <= Int(rhs.rawValue)
+            }
+        }
+
+        /// Returns a Boolean value that indicates whether the first demand requests fewer
+        /// elements than the second.
+        /// If both sides are `.unlimited`, the result is always `false`.
+        /// If `lhs` is `.unlimited`, then the result is always `false`.
+        /// If `rhs` is `.unlimited`, then the result is always `true`.
+        /// Otherwise, this operator compares the demands’ `max` values.
+        @inline(__always)
+        @inlinable
+        public static func < (lhs: Demand, rhs: Demand) -> Bool {
+            switch (lhs, rhs) {
+            case (.unlimited, _):
+                return false
+            case (_, .unlimited):
+                return true
+            default:
+                return lhs.rawValue < rhs.rawValue
+            }
+        }
+
+        /// Returns a Boolean value that indicates whether the first demand requests fewer
+        /// or the same number of elements as the second.
+        /// If both sides are `.unlimited`, the result is always `true`.
+        /// If `lhs` is `.unlimited`, then the result is always `false`.
+        /// If `rhs` is `.unlimited` then the result is always `true`.
+        /// Otherwise, this operator compares the demands’ `max` values.
+        @inline(__always)
+        @inlinable
+        public static func <= (lhs: Demand, rhs: Demand) -> Bool {
+            switch (lhs, rhs) {
+            case (.unlimited, .unlimited):
+                return true
+            case (.unlimited, _):
+                return false
+            case (_, .unlimited):
+                return true
+            default:
+                return lhs.rawValue <= rhs.rawValue
+            }
+        }
+
+        /// Returns a Boolean that indicates whether the first demand requests more or
+        /// the same number of elements as the second.
+        /// If both sides are `.unlimited`, the result is always `false`.
+        /// If `lhs` is `.unlimited`, then the result is always `true`.
+        /// If rhs is `.unlimited` then the result is always `false`.
+        /// Otherwise, this operator compares the demands’ `max` values.
+        @inline(__always)
+        @inlinable
+        public static func >= (lhs: Demand, rhs: Demand) -> Bool {
+            switch (lhs, rhs) {
+            case (.unlimited, .unlimited):
+                return true
+            case (.unlimited, _):
+                return true
+            case (_, .unlimited):
+                return false
+            default:
+                return lhs.rawValue >= rhs.rawValue
+            }
+        }
+
+        /// Returns a Boolean that indicates whether the first demand requests more
+        /// elements than the second.
+        /// If both sides are `.unlimited`, the result is always `false`.
+        /// If `lhs` is `.unlimited`, then the result is always `true`.
+        /// If `rhs` is `.unlimited` then the result is always `false`.
+        /// Otherwise, this operator compares the demands’ `max` values.
+        @inline(__always)
+        @inlinable
+        public static func > (lhs: Demand, rhs: Demand) -> Bool {
+            switch (lhs, rhs) {
+            case (.unlimited, .unlimited):
+                return false
+            case (.unlimited, _):
+                return true
+            case (_, .unlimited):
+                return false
+            default:
+                return lhs.rawValue > rhs.rawValue
+            }
+        }
+
+        /// Returns a Boolean value indicating whether a demand requests the given number
+        /// of elements.
+        /// An `.unlimited` demand doesn’t match any integer.
+        @inline(__always)
+        @inlinable
+        public static func == (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return false
+            } else {
+                return Int(lhs.rawValue) == rhs
+            }
+        }
+
+        /// Returns a Boolean value indicating whether a demand is not equal to
+        /// an integer.
+        /// The `.unlimited` value isn’t equal to any integer.
+        @inlinable
+        public static func != (lhs: Demand, rhs: Int) -> Bool {
+            if lhs == .unlimited {
+                return true
+            } else {
+                return Int(lhs.rawValue) != rhs
+            }
+        }
+
+        /// Returns a Boolean value indicating whether a given number of elements matches
+        /// the request of a given demand.
+        /// An `.unlimited` demand doesn’t match any integer.
+        @inlinable
+        public static func == (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return false
+            } else {
+                return rhs.rawValue == lhs
+            }
+        }
+
+        /// Returns a Boolean value indicating whether an integer is not equal to
+        /// a demand.
+        /// The `.unlimited` value isn’t equal to any integer.
+        @inlinable
+        public static func != (lhs: Int, rhs: Demand) -> Bool {
+            if rhs == .unlimited {
+                return true
+            } else {
+                return Int(rhs.rawValue) != lhs
+            }
+        }
+
+        @inlinable
+        public static func == (lhs: Demand, rhs: Demand) -> Bool {
+            return lhs.rawValue == rhs.rawValue
+        }
+
+        /// The number of requested values.
+        ///
+        /// The value is `nil` if the demand is `Subscribers.Demand.unlimited`.
+        @inlinable public var max: Int? {
+            if self == .unlimited {
+                return nil
+            } else {
+                return Int(rawValue)
+            }
+        }
+
+        /// Creates a demand instance from a decoder.
+        ///
+        /// - Parameter decoder: The decoder of a previously-encoded `Subscribers.Demand`
+        ///   instance.
+        public init(from decoder: Decoder) throws {
+            try self.init(rawValue: decoder.singleValueContainer().decode(UInt.self))
+        }
+
+        /// Encodes the demand to the provided encoder.
+        ///
+        /// - Parameter encoder: An encoder instance.
+        public func encode(to encoder: Encoder) throws {
+            var container = encoder.singleValueContainer()
+            try container.encode(rawValue)
+        }
+    }
+}
+
+#if canImport(_Concurrency) && compiler(>=5.5) || compiler(>=5.5.1)
+extension Subscribers.Demand: Sendable {}
+#endif

package/Sources/Combine/Subscribers/Subscribers.Sink.swift

@@ -0,0 +1,206 @@
+//
+//  Subscribers.Sink.swift
+//  
+//
+//  Created by Sergej Jaskiewicz on 16.06.2019.
+//
+
+extension Subscribers {
+
+    /// A simple subscriber that requests an unlimited number of values upon subscription.
+    public final class Sink<Input, Failure: Error>
+        : Subscriber,
+          Cancellable,
+          CustomStringConvertible,
+          CustomReflectable,
+          CustomPlaygroundDisplayConvertible
+    {
+
+        /// The closure to execute on receipt of a value.
+        public var receiveValue: (Input) -> Void
+
+        /// The closure to execute on completion.
+        public var receiveCompletion: (Subscribers.Completion<Failure>) -> Void
+
+        private var status = SubscriptionStatus.awaitingSubscription
+
+        private let lock = UnfairLock.allocate()
+
+        public var description: String { return "Sink" }
+
+        public var customMirror: Mirror {
+            return Mirror(self, children: EmptyCollection())
+        }
+
+        public var playgroundDescription: Any { return description }
+
+        /// Initializes a sink with the provided closures.
+        ///
+        /// - Parameters:
+        ///   - receiveCompletion: The closure to execute on completion.
+        ///   - receiveValue: The closure to execute on receipt of a value.
+        public init(
+            receiveCompletion: @escaping (Subscribers.Completion<Failure>) -> Void,
+            receiveValue: @escaping ((Input) -> Void)
+        ) {
+            self.receiveCompletion = receiveCompletion
+            self.receiveValue = receiveValue
+        }
+
+        deinit {
+            lock.deallocate()
+        }
+
+        public func receive(subscription: Subscription) {
+            lock.lock()
+            guard case .awaitingSubscription = status else {
+                lock.unlock()
+                subscription.cancel()
+                return
+            }
+            status = .subscribed(subscription)
+            lock.unlock()
+            subscription.request(.unlimited)
+        }
+
+        public func receive(_ value: Input) -> Subscribers.Demand {
+            lock.lock()
+            let receiveValue = self.receiveValue
+            lock.unlock()
+            receiveValue(value)
+            return .none
+        }
+
+        public func receive(completion: Subscribers.Completion<Failure>) {
+            lock.lock()
+            status = .terminal
+            let receiveCompletion = self.receiveCompletion
+            self.receiveCompletion = { _ in }
+
+            // We MUST release the closures AFTER unlocking the lock,
+            // since releasing a closure may trigger execution of arbitrary code,
+            // for example, if the closure captures an object with a deinit.
+            // When closure deallocates, the object's deinit is called, and holding
+            // the lock at that moment can lead to deadlocks.
+            // See https://github.com/OpenCombine/OpenCombine/issues/208
+
+            withExtendedLifetime(receiveValue) {
+                receiveValue = { _ in }
+                lock.unlock()
+            }
+
+            receiveCompletion(completion)
+        }
+
+        public func cancel() {
+            lock.lock()
+            guard case let .subscribed(subscription) = status else {
+                lock.unlock()
+                return
+            }
+            status = .terminal
+
+            // We MUST release the closures AFTER unlocking the lock,
+            // since releasing a closure may trigger execution of arbitrary code,
+            // for example, if the closure captures an object with a deinit.
+            // When closure deallocates, the object's deinit is called, and holding
+            // the lock at that moment can lead to deadlocks.
+            // See https://github.com/OpenCombine/OpenCombine/issues/208
+
+            withExtendedLifetime((receiveValue, receiveCompletion)) {
+                receiveCompletion = { _ in }
+                receiveValue = { _ in }
+                lock.unlock()
+            }
+            subscription.cancel()
+        }
+    }
+}
+
+extension Publisher {
+
+    /// Attaches a subscriber with closure-based behavior.
+    ///
+    /// Use `sink(receiveCompletion:receiveValue:)` to observe values received by
+    /// the publisher and process them using a closure you specify.
+    ///
+    /// In this example, a `Range` publisher publishes integers to
+    /// a `sink(receiveCompletion:receiveValue:)` operator’s `receiveValue` closure that
+    /// prints them to the console. Upon completion
+    /// the `sink(receiveCompletion:receiveValue:)` operator’s `receiveCompletion` closure
+    /// indicates the successful termination of the stream.
+    ///
+    ///     let myRange = (0...3)
+    ///     cancellable = myRange.publisher
+    ///         .sink(receiveCompletion: { print ("completion: \($0)") },
+    ///               receiveValue: { print ("value: \($0)") })
+    ///
+    ///     // Prints:
+    ///     //  value: 0
+    ///     //  value: 1
+    ///     //  value: 2
+    ///     //  value: 3
+    ///     //  completion: finished
+    ///
+    /// This method creates the subscriber and immediately requests an unlimited number
+    /// of values, prior to returning the subscriber.
+    /// The return value should be held, otherwise the stream will be canceled.
+    ///
+    /// - parameter receiveComplete: The closure to execute on completion.
+    /// - parameter receiveValue: The closure to execute on receipt of a value.
+    /// - Returns: A cancellable instance, which you use when you end assignment of
+    ///   the received value. Deallocation of the result will tear down the subscription
+    ///   stream.
+    public func sink(
+        receiveCompletion: @escaping (Subscribers.Completion<Failure>) -> Void,
+        receiveValue: @escaping ((Output) -> Void)
+    ) -> AnyCancellable {
+        let subscriber = Subscribers.Sink<Output, Failure>(
+            receiveCompletion: receiveCompletion,
+            receiveValue: receiveValue
+        )
+        subscribe(subscriber)
+        return AnyCancellable(subscriber)
+    }
+}
+
+extension Publisher where Failure == Never {
+
+    /// Attaches a subscriber with closure-based behavior to a publisher that never fails.
+    ///
+    /// Use `sink(receiveValue:)` to observe values received by the publisher and print
+    /// them to the console. This operator can only be used when the stream doesn’t fail,
+    /// that is, when the publisher’s `Failure` type is `Never`.
+    ///
+    /// In this example, a `Range` publisher publishes integers to a `sink(receiveValue:)`
+    /// operator’s `receiveValue` closure that prints them to the console:
+    ///
+    ///     let integers = (0...3)
+    ///     integers.publisher
+    ///         .sink { print("Received \($0)") }
+    ///
+    ///     // Prints:
+    ///     //  Received 0
+    ///     //  Received 1
+    ///     //  Received 2
+    ///     //  Received 3
+    ///
+    /// This method creates the subscriber and immediately requests an unlimited number of
+    /// values, prior to returning the subscriber.
+    /// The return value should be held, otherwise the stream will be canceled.
+    ///
+    /// - parameter receiveValue: The closure to execute on receipt of a value.
+    /// - Returns: A cancellable instance, which you use when you end assignment of
+    ///   the received value. Deallocation of the result will tear down the subscription
+    ///   stream.
+    public func sink(
+        receiveValue: @escaping (Output) -> Void
+    ) -> AnyCancellable {
+        let subscriber = Subscribers.Sink<Output, Failure>(
+            receiveCompletion: { _ in },
+            receiveValue: receiveValue
+        )
+        subscribe(subscriber)
+        return AnyCancellable(subscriber)
+    }
+}

package/Sources/Combine/Subscribers/Subscribers.swift

@@ -0,0 +1,9 @@
+//
+//  Subscribers.swift
+//  
+//
+//  Created by Sergej Jaskiewicz on 10.06.2019.
+//
+
+/// A namespace for types related to the `Subscriber` protocol.
+public enum Subscribers {}