@octane-xplat/lottie 0.9.0 → 0.11.0

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Views/BehaviorsConfigurableView.swift

@@ -0,0 +1,45 @@
+// Created by Tyler Hedrick on 5/26/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - BehaviorsConfigurableView
+
+/// A view that can be configured with a `Behaviors` instance that contains the view's non-
+/// `Equatable` properties that can be updated on view instances after initialization, e.g. callback
+/// closures or delegates.
+///
+/// Since it is not possible to establish the equality of two `Behaviors` instances, `Behaviors`
+/// will be set more often than `ContentConfigurableView.Content`, needing to be updated every time
+/// the view's corresponding `EpoxyModeled` instance is updated. As such, setting behaviors should
+/// be as lightweight as possible.
+///
+/// Properties of `Behaviors` should be mutually exclusive with the properties in the
+/// `StyledView.Style` and `ContentConfigurableView.Content`.
+///
+/// - SeeAlso: `ContentConfigurableView`
+/// - SeeAlso: `StyledView`
+/// - SeeAlso: `EpoxyableView`
+protocol BehaviorsConfigurableView: ViewType {
+  /// The non-`Equatable` properties that can be changed over of the lifecycle this View's
+  /// instances, e.g. callback closures or delegates.
+  ///
+  /// Defaults to `Never` for views that do not have `Behaviors`.
+  associatedtype Behaviors = Never
+
+  /// Updates the behaviors of this view to those in the given `behaviors`, else resets the
+  /// behaviors if `nil`.
+  ///
+  /// Behaviors are optional as they must be "resettable" in order for Epoxy to reset the behaviors
+  /// on your view when no behaviors are provided.
+  func setBehaviors(_ behaviors: Self.Behaviors?)
+}
+
+// MARK: Defaults
+
+extension BehaviorsConfigurableView where Behaviors == Never {
+  func setBehaviors(_ behaviors: Never?) {
+    switch behaviors {
+    case nil:
+      break
+    }
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Views/ContentConfigurableView.swift

@@ -0,0 +1,36 @@
+//  Created by Laura Skelton on 5/30/17.
+//  Copyright © 2017 Airbnb. All rights reserved.
+
+// MARK: - ContentConfigurableView
+
+/// A view that can be configured with a `Content` instance that contains the view's `Equatable`
+/// properties that can be updated on existing view instances, e.g. text `String`s or image `URL`s.
+///
+/// For performance, it is generally expected that `Content` is only set when it is not equal to the
+/// previous `Content` instance that has been set on a view instance. As a further optimization,
+/// this view can guard updates on the equality of each property of the `Content` against the
+/// current property value when set.
+///
+/// Properties of `Content` should be mutually exclusive with the properties of the
+/// `StyledView.Style` and `BehaviorsConfigurableView.Behaviors`.
+///
+/// - SeeAlso: `BehaviorsConfigurableView`
+/// - SeeAlso: `StyledView`
+/// - SeeAlso: `EpoxyableView`
+protocol ContentConfigurableView: ViewType {
+  /// The `Equatable` properties that can be updated on instances of this view, e.g. text `String`s
+  /// or image `URL`s.
+  ///
+  /// Defaults to `Never` for views that do not have `Content`.
+  associatedtype Content: Equatable = Never
+
+  /// Updates the content of this view to the properties of the given `content`, optionally
+  /// animating the updates.
+  func setContent(_ content: Self.Content, animated: Bool)
+}
+
+// MARK: Defaults
+
+extension ContentConfigurableView where Content == Never {
+  func setContent(_: Never, animated _: Bool) { }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Views/EpoxyableView.swift

@@ -0,0 +1,5 @@
+// Created by eric_horacek on 1/13/21.
+// Copyright © 2021 Airbnb Inc. All rights reserved.
+
+/// A `UIView` that can be declaratively configured via a concrete `EpoxyableModel` instance.
+typealias EpoxyableView = BehaviorsConfigurableView & ContentConfigurableView & StyledView

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Views/StyledView.swift

@@ -0,0 +1,43 @@
+//  Created by Laura Skelton on 4/14/16.
+//  Copyright © 2016 Airbnb. All rights reserved.
+
+// MARK: - StyledView
+
+/// A view that can be initialized with a `Style` instance that contains the view's invariant
+/// configuration parameters, e.g. the `UIButton.ButtonType` of a `UIButton`.
+///
+/// A `Style` is expected to be invariant over the lifecycle of the view; it should not possible to
+/// change the `Style` of a view after it is created. All variant properties of the view should
+/// either be included in the `ContentConfigurableView.Content` if they are `Equatable` (e.g. a
+/// title `String`) or the `BehaviorsConfigurableView.Behaviors` if they are not (e.g. a callback
+/// closure).
+///
+/// A `Style` is `Hashable` to allow views of the same type with equal `Style`s to be reused by
+/// establishing whether their invariant `Style` instances are equal.
+///
+/// Properties of `Style` should be mutually exclusive with the properties of the
+/// `ContentConfigurableView.Content` and `BehaviorsConfigurableView.Behaviors`.
+///
+/// - SeeAlso: `ContentConfigurableView`
+/// - SeeAlso: `BehaviorsConfigurableView`
+/// - SeeAlso: `EpoxyableView`
+protocol StyledView: ViewType {
+  /// Creates an instance of this view configured with the given `Style` instance.
+  init(style: Style)
+
+  /// The style type of this view, passed into its initializer to configure the resulting instance.
+  ///
+  /// Defaults to `Never` for views that do not have a `Style`.
+  associatedtype Style: Hashable = Never
+
+}
+
+// MARK: Defaults
+
+extension StyledView where Style == Never {
+  init(style: Never) {
+    // An empty switch is required to silence the "'self.init' isn't called on all paths before
+    // returning from initializer" error.
+    switch style { }
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Views/ViewType.swift

@@ -0,0 +1,47 @@
+// Created by Cal Stephens on 6/26/23.
+// Copyright © 2023 Airbnb Inc. All rights reserved.
+
+import SwiftUI
+
+#if os(iOS) || os(tvOS) || os(visionOS)
+import UIKit
+
+/// The platform's main view type.
+/// Either `UIView` on iOS/tvOS or `NSView` on macOS.
+typealias ViewType = UIView
+
+/// The platform's SwiftUI view representable type.
+/// Either `UIViewRepresentable` on iOS/tvOS or `NSViewRepresentable` on macOS.
+typealias ViewRepresentableType = UIViewRepresentable
+
+/// The platform's layout constraint priority type.
+/// Either `UILayoutPriority` on iOS/tvOS or `NSLayoutConstraint.Priority` on macOS.
+typealias LayoutPriorityType = UILayoutPriority
+
+extension ViewRepresentableType {
+  /// The platform's view type for `ViewRepresentableType`.
+  /// Either `UIViewType` on iOS/tvOS or `NSViewType` on macOS.
+  typealias RepresentableViewType = UIViewType
+}
+
+#elseif os(macOS)
+import AppKit
+
+/// The platform's main view type.
+/// Either `UIView` on iOS/tvOS, or `NSView` on macOS.
+typealias ViewType = NSView
+
+/// The platform's SwiftUI view representable type.
+/// Either `UIViewRepresentable` on iOS/tvOS, or `NSViewRepresentable` on macOS.
+typealias ViewRepresentableType = NSViewRepresentable
+
+/// The platform's layout constraint priority type.
+/// Either `UILayoutPriority` on iOS/tvOS, or `NSLayoutConstraint.Priority` on macOS.
+typealias LayoutPriorityType = NSLayoutConstraint.Priority
+
+extension ViewRepresentableType {
+  /// The platform's view type for `ViewRepresentableType`.
+  /// Either `UIViewType` on iOS/tvOS or `NSViewType` on macOS.
+  typealias RepresentableViewType = NSViewType
+}
+#endif

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/LRUCache/LRUCache.swift

@@ -0,0 +1,257 @@
+//
+//  LRUCache.swift
+//  LRUCache
+//
+//  Version 1.0.2
+//
+//  Created by Nick Lockwood on 05/08/2021.
+//  Copyright © 2021 Nick Lockwood. All rights reserved.
+//
+//  Distributed under the permissive MIT license
+//  Get the latest version from here:
+//
+//  https://github.com/nicklockwood/LRUCache
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the "Software"), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in all
+//  copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+//  SOFTWARE.
+//
+
+import Foundation
+
+#if canImport(UIKit)
+import UIKit
+
+/// Notification that cache should be cleared
+let LRUCacheMemoryWarningNotification: NSNotification.Name =
+  UIApplication.didReceiveMemoryWarningNotification
+
+#else
+
+/// Notification that cache should be cleared
+let LRUCacheMemoryWarningNotification =
+  NSNotification.Name("LRUCacheMemoryWarningNotification")
+
+#endif
+
+// MARK: - LRUCache
+
+final class LRUCache<Key: Hashable, Value> {
+
+  // MARK: Lifecycle
+
+  /// Initialize the cache with the specified `totalCostLimit` and `countLimit`
+  init(
+    totalCostLimit: Int = .max,
+    countLimit: Int = .max,
+    notificationCenter: NotificationCenter = .default
+  ) {
+    self.totalCostLimit = totalCostLimit
+    self.countLimit = countLimit
+    self.notificationCenter = notificationCenter
+
+    token = notificationCenter.addObserver(
+      forName: LRUCacheMemoryWarningNotification,
+      object: nil,
+      queue: nil
+    ) { [weak self] _ in
+      self?.removeAllValues()
+    }
+  }
+
+  deinit {
+    if let token {
+      notificationCenter.removeObserver(token)
+    }
+  }
+
+  // MARK: Internal
+
+  /// The current total cost of values in the cache
+  private(set) var totalCost = 0
+
+  /// The maximum total cost permitted
+  var totalCostLimit: Int {
+    didSet { clean() }
+  }
+
+  /// The maximum number of values permitted
+  var countLimit: Int {
+    didSet { clean() }
+  }
+
+  // MARK: Private
+
+  private var values = [Key: Container]()
+  private unowned(unsafe) var head: Container?
+  private unowned(unsafe) var tail: Container?
+  private let lock = NSLock()
+  private var token: AnyObject?
+  private let notificationCenter: NotificationCenter
+
+}
+
+extension LRUCache {
+  /// The number of values currently stored in the cache
+  var count: Int {
+    values.count
+  }
+
+  /// Is the cache empty?
+  var isEmpty: Bool {
+    values.isEmpty
+  }
+
+  /// Returns all values in the cache from oldest to newest
+  var allValues: [Value] {
+    lock.lock()
+    defer { lock.unlock() }
+    var values = [Value]()
+    var next = head
+    while let container = next {
+      values.append(container.value)
+      next = container.next
+    }
+    return values
+  }
+
+  /// Insert a value into the cache with optional `cost`
+  func setValue(_ value: Value?, forKey key: Key, cost: Int = 0) {
+    guard let value else {
+      removeValue(forKey: key)
+      return
+    }
+    lock.lock()
+    if let container = values[key] {
+      container.value = value
+      totalCost -= container.cost
+      container.cost = cost
+      remove(container)
+      append(container)
+    } else {
+      let container = Container(
+        value: value,
+        cost: cost,
+        key: key
+      )
+      values[key] = container
+      append(container)
+    }
+    totalCost += cost
+    lock.unlock()
+    clean()
+  }
+
+  /// Remove a value  from the cache and return it
+  @discardableResult
+  func removeValue(forKey key: Key) -> Value? {
+    lock.lock()
+    defer { lock.unlock() }
+    guard let container = values.removeValue(forKey: key) else {
+      return nil
+    }
+    remove(container)
+    totalCost -= container.cost
+    return container.value
+  }
+
+  /// Fetch a value from the cache
+  func value(forKey key: Key) -> Value? {
+    lock.lock()
+    defer { lock.unlock() }
+    if let container = values[key] {
+      remove(container)
+      append(container)
+      return container.value
+    }
+    return nil
+  }
+
+  /// Remove all values from the cache
+  func removeAllValues() {
+    lock.lock()
+    values.removeAll()
+    head = nil
+    tail = nil
+    lock.unlock()
+  }
+}
+
+extension LRUCache {
+
+  // MARK: Fileprivate
+
+  fileprivate final class Container {
+
+    // MARK: Lifecycle
+
+    init(value: Value, cost: Int, key: Key) {
+      self.value = value
+      self.cost = cost
+      self.key = key
+    }
+
+    // MARK: Internal
+
+    var value: Value
+    var cost: Int
+    let key: Key
+    unowned(unsafe) var prev: Container?
+    unowned(unsafe) var next: Container?
+
+  }
+
+  // MARK: Private
+
+  /// Remove container from list (must be called inside lock)
+  private func remove(_ container: Container) {
+    if head === container {
+      head = container.next
+    }
+    if tail === container {
+      tail = container.prev
+    }
+    container.next?.prev = container.prev
+    container.prev?.next = container.next
+    container.next = nil
+  }
+
+  /// Append container to list (must be called inside lock)
+  private func append(_ container: Container) {
+    assert(container.next == nil)
+    if head == nil {
+      head = container
+    }
+    container.prev = tail
+    tail?.next = container
+    tail = container
+  }
+
+  /// Remove expired values (must be called outside lock)
+  private func clean() {
+    lock.lock()
+    defer { lock.unlock() }
+    while
+      totalCost > totalCostLimit || count > countLimit,
+      let container = head
+    {
+      remove(container)
+      values.removeValue(forKey: container.key)
+      totalCost -= container.cost
+    }
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/LRUCache/README.md

@@ -0,0 +1,24 @@
+## LRUCache
+
+This directory includes the source code of the LRUCache library, from the following release:
+https://github.com/nicklockwood/LRUCache/releases/tag/1.0.4
+
+Lottie is distributed via multiple package managers (SPM, Cocoapods, Carthage, and NPM),
+each with different packaging and compilation requirements.
+
+Due to limitations of these package managers, we can't depend on / import
+a separate LRUCache module / library. Instead, we include the source
+directly within the Lottie library and compile everything as a single unit.
+
+### Update instructions
+
+From time to time we may need to update to a more recent version of LRUCache.
+When doing this, follow these steps:
+
+ 1. Download the latest release from https://github.com/nicklockwood/LRUCache
+    and replace the source code in this directory with the updated code.
+
+ 2. Update the URL at the top of this file to indicate what release is being used.
+
+ 3. Change all of the `public` symbols defined in this module to instead be `internal`
+    to prevent Lottie from exposing any EpoxyCore APIs.

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/README.md

@@ -0,0 +1,43 @@
+## ZipFoundation
+
+This directory includes the source code of libraries that are embedded within lottie-ios.
+
+This includes:
+ - ZipFoundation (https://github.com/weichsel/ZIPFoundation)
+ - EpoxyCore (https://github.com/airbnb/epoxy-ios)
+ - LRUCache (https://github.com/nicklockwood/LRUCache)
+
+Lottie is distributed via multiple package managers (SPM, Cocoapods, Carthage, and NPM),
+each with different packaging and compilation requirements.
+
+Due to limitations of these package managers, we can't depend on / import
+a separates modules / libraries. Instead, we include the source
+directly within the Lottie library and compile everything as a single unit.
+
+### Update instructions
+
+From time to time we may need to update to a more recent version of one of these libraries.
+When doing this, follow these steps:
+
+ 1. Download the latest release of the library and replace the source code in
+    the corresponding directory with the updated code.
+
+ 2. Update the URL in the directory's README.md to indicate what release is being used.
+
+ 3. Change all of the `public` symbols defined in the module to instead be `internal`
+    to prevent Lottie from exposing any APIs from other libraries.
+
+### Adding a new dependencies
+
+ 1. Create a subdirectory in `EmbeddedLibraries` for the new dependency.
+
+ 2. Add the dependency to the list at the top of this file.
+
+ 3. Add a `README.md` to the directory for the new library, using the same formatting as the `README.md` file used by other dependencies.
+
+ 4. Exclude the new `README.md` file from the lottie-ios package by adding it to the `exclude:` list in `Package.swift`.
+
+ 5. Change all of the `public` symbols defined in the module to instead be `internal`
+    to prevent Lottie from exposing any APIs from other libraries.
+
+ 6. If the dependency provides a privacy manifest, incorporate content from that dependency's privacy manifest into Lottie's privacy manifest.

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/ZipFoundation/Archive+BackingConfiguration.swift

@@ -0,0 +1,149 @@
+//
+//  Archive+BackingConfiguration.swift
+//  ZIPFoundation
+//
+//  Copyright © 2017-2025 Thomas Zoechling, https://www.peakstep.com and the ZIP Foundation project authors.
+//  Released under the MIT License.
+//
+//  See https://github.com/weichsel/ZIPFoundation/blob/master/LICENSE for license information.
+//
+
+import Foundation
+
+extension Archive {
+
+  struct BackingConfiguration {
+    let file: FILEPointer
+    let endOfCentralDirectoryRecord: EndOfCentralDirectoryRecord
+    let zip64EndOfCentralDirectory: ZIP64EndOfCentralDirectory?
+    #if swift(>=5.0)
+    let memoryFile: MemoryFile?
+
+    init(
+      file: FILEPointer,
+      endOfCentralDirectoryRecord: EndOfCentralDirectoryRecord,
+      zip64EndOfCentralDirectory: ZIP64EndOfCentralDirectory? = nil,
+      memoryFile: MemoryFile? = nil
+    ) {
+      self.file = file
+      self.endOfCentralDirectoryRecord = endOfCentralDirectoryRecord
+      self.zip64EndOfCentralDirectory = zip64EndOfCentralDirectory
+      self.memoryFile = memoryFile
+    }
+    #else
+
+    init(
+      file: FILEPointer,
+      endOfCentralDirectoryRecord: EndOfCentralDirectoryRecord,
+      zip64EndOfCentralDirectory: ZIP64EndOfCentralDirectory?
+    ) {
+      self.file = file
+      self.endOfCentralDirectoryRecord = endOfCentralDirectoryRecord
+      self.zip64EndOfCentralDirectory = zip64EndOfCentralDirectory
+    }
+    #endif
+  }
+
+  static func makeBackingConfiguration(for url: URL, mode: AccessMode) throws
+    -> BackingConfiguration
+  {
+    let fileManager = FileManager()
+    switch mode {
+    case .read:
+      let fileSystemRepresentation = fileManager.fileSystemRepresentation(withPath: url.path)
+      guard let archiveFile = fopen(fileSystemRepresentation, "rb") else {
+        throw POSIXError(errno, path: url.path)
+      }
+      guard let (eocdRecord, zip64EOCD) = Archive.scanForEndOfCentralDirectoryRecord(in: archiveFile) else {
+        fclose(archiveFile)
+        throw ArchiveError.missingEndOfCentralDirectoryRecord
+      }
+      return BackingConfiguration(
+        file: archiveFile,
+        endOfCentralDirectoryRecord: eocdRecord,
+        zip64EndOfCentralDirectory: zip64EOCD
+      )
+
+    case .create:
+      let endOfCentralDirectoryRecord = EndOfCentralDirectoryRecord(
+        numberOfDisk: 0,
+        numberOfDiskStart: 0,
+        totalNumberOfEntriesOnDisk: 0,
+        totalNumberOfEntriesInCentralDirectory: 0,
+        sizeOfCentralDirectory: 0,
+        offsetToStartOfCentralDirectory: 0,
+        zipFileCommentLength: 0,
+        zipFileCommentData: Data()
+      )
+      try endOfCentralDirectoryRecord.data.write(to: url, options: .withoutOverwriting)
+      fallthrough
+
+    case .update:
+      let fileSystemRepresentation = fileManager.fileSystemRepresentation(withPath: url.path)
+      guard let archiveFile = fopen(fileSystemRepresentation, "rb+") else {
+        throw POSIXError(errno, path: url.path)
+      }
+      guard let (eocdRecord, zip64EOCD) = Archive.scanForEndOfCentralDirectoryRecord(in: archiveFile) else {
+        fclose(archiveFile)
+        throw ArchiveError.missingEndOfCentralDirectoryRecord
+      }
+      fseeko(archiveFile, 0, SEEK_SET)
+      return BackingConfiguration(
+        file: archiveFile,
+        endOfCentralDirectoryRecord: eocdRecord,
+        zip64EndOfCentralDirectory: zip64EOCD
+      )
+    }
+  }
+
+  #if swift(>=5.0)
+  static func makeBackingConfiguration(for data: Data, mode: AccessMode) throws
+    -> BackingConfiguration
+  {
+    let memoryFile = MemoryFile(data: data)
+    let archiveFile = try memoryFile.open(mode: mode)
+    switch mode {
+    case .read:
+      guard let (eocdRecord, zip64EOCD) = Archive.scanForEndOfCentralDirectoryRecord(in: archiveFile) else {
+        throw ArchiveError.missingEndOfCentralDirectoryRecord
+      }
+
+      return BackingConfiguration(
+        file: archiveFile,
+        endOfCentralDirectoryRecord: eocdRecord,
+        zip64EndOfCentralDirectory: zip64EOCD,
+        memoryFile: memoryFile
+      )
+
+    case .create:
+      let endOfCentralDirectoryRecord = EndOfCentralDirectoryRecord(
+        numberOfDisk: 0,
+        numberOfDiskStart: 0,
+        totalNumberOfEntriesOnDisk: 0,
+        totalNumberOfEntriesInCentralDirectory: 0,
+        sizeOfCentralDirectory: 0,
+        offsetToStartOfCentralDirectory: 0,
+        zipFileCommentLength: 0,
+        zipFileCommentData: Data()
+      )
+      _ = endOfCentralDirectoryRecord.data.withUnsafeBytes { (buffer: UnsafeRawBufferPointer) in
+        fwrite(buffer.baseAddress, buffer.count, 1, archiveFile) // Errors handled during read
+      }
+      fallthrough
+
+    case .update:
+      guard let (eocdRecord, zip64EOCD) = Archive.scanForEndOfCentralDirectoryRecord(in: archiveFile) else {
+        throw ArchiveError.missingEndOfCentralDirectoryRecord
+      }
+
+      fseeko(archiveFile, 0, SEEK_SET)
+      return BackingConfiguration(
+        file: archiveFile,
+        endOfCentralDirectoryRecord: eocdRecord,
+        zip64EndOfCentralDirectory: zip64EOCD,
+        memoryFile: memoryFile
+      )
+    }
+  }
+  #endif
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/ZipFoundation/Archive+Deprecated.swift

@@ -0,0 +1,23 @@
+//
+//  Archive+Deprecated.swift
+//  ZIPFoundation
+//
+//  Created by Thomas Zoechling on 06.02.23.
+//
+
+import Foundation
+
+extension Archive {
+
+  @available(*, deprecated, message: "Please use the throwing initializer.")
+  convenience init?(url: URL, accessMode mode: AccessMode, preferredEncoding: String.Encoding? = nil) {
+    try? self.init(url: url, accessMode: mode, pathEncoding: preferredEncoding)
+  }
+
+  #if swift(>=5.0)
+  @available(*, deprecated, message: "Please use the throwing initializer.")
+  convenience init?(data: Data = Data(), accessMode mode: AccessMode, preferredEncoding: String.Encoding? = nil) {
+    try? self.init(data: data, accessMode: mode, pathEncoding: preferredEncoding)
+  }
+  #endif
+}