deprecate netrc (#287)

motivation: move netrc to SwiftPM

changes: mark netrc utilities and tests as deprecated

Author: tomerd

Sources/TSCUtility/Netrc.swift

@@ -23,6 +23,8 @@ extension AuthorizationProviding {
  which is only available in macOS 10.13+, iOS 11+, etc at this time.
  */
 /// Container of parsed netrc connection settings
+// FIXME: deprecate 2/2022, remove once clients transitioned
+@available(*, deprecated, message: "moved to SwiftPM")
 @available (macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 public struct Netrc {
     /// Representation of `machine` connection settings & `default` connection settings.
@@ -98,6 +100,8 @@ public struct Netrc {
 @available (macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 extension Netrc: AuthorizationProviding {}
 
+// FIXME: deprecate 2/2022, remove once clients transitioned
+@available(*, deprecated, message: "moved to SwiftPM")
 @available (macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 public extension Netrc {
     enum Error: Swift.Error {
@@ -136,13 +140,17 @@ public extension Netrc {
     }
 }
 
+// FIXME: deprecate 2/2022, remove once clients transitioned
+@available(*, deprecated, message: "moved to SwiftPM")
 @available (macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 extension Netrc.Error: CustomNSError {
     public var errorUserInfo: [String : Any] {
         return [NSLocalizedDescriptionKey: "\(self)"]
     }
 }
 
+// FIXME: deprecate 2/2022, remove once clients transitioned
+@available(*, deprecated, message: "moved to SwiftPM")
 @available (macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 fileprivate enum RegexUtil {
     @frozen fileprivate enum Token: String, CaseIterable {

Tests/TSCUtilityTests/NetrcTests.swift

@@ -1,9 +1,11 @@
 import XCTest
 import TSCUtility
 
-@available(macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
+// FIXME: deprecate 2/2022, remove once clients transitioned
+@available(*, deprecated, message: "moved to SwiftPM")
 /// Netrc feature depends upon `NSTextCheckingResult.range(withName name: String) -> NSRange`,
 /// which is only available in macOS 10.13+ at this time.
+@available(macOS 10.13, iOS 11, tvOS 11, watchOS 4, *)
 class NetrcTests: XCTestCase {
     /// should load machines for a given inline format
     func testLoadMachinesInline() {