mark some UnidocDB API as unused

Author: tayloraswift

Sources/HTTPClient/HTTP2Client.swift

@@ -84,11 +84,11 @@ extension HTTP2Client
 {
     /// Connect to the remote host over HTTPS and perform the given operation.
     @inlinable public
-    func connect<T>(with body:(Connection) async throws -> T) async throws -> T
+    func connect<T>(port:Int = 443, with body:(Connection) async throws -> T) async throws -> T
     {
         let channel:any Channel = try await self.bootstrap.connect(
             host: self.remote,
-            port: 443).get()
+            port: port).get()
 
         defer
         {

Sources/UnidocBuild/Main.swift

@@ -22,7 +22,7 @@ enum Main
         let http2:HTTP2Client = .init(
             threads: threads,
             niossl: niossl,
-            remote: "swiftinit.org")
+            remote: options.remote)
 
         let swiftinit:SwiftinitClient = .init(http2: http2)
 
@@ -42,11 +42,13 @@ extension Main
     struct Options
     {
         var package:PackageIdentifier
+        var remote:String
 
         private
         init(package:PackageIdentifier)
         {
             self.package = package
+            self.remote = "swiftinit.org"
         }
     }
 }
@@ -64,7 +66,28 @@ extension Main.Options
             fatalError("Usage: \(CommandLine.arguments[0]) <package>")
         }
 
-        return .init(package: .init(package))
+        var options:Self = .init(package: .init(package))
+
+        while let option:String = arguments.popFirst()
+        {
+            switch option
+            {
+            case "--remote", "-h":
+                guard
+                let remote:String = arguments.popFirst()
+                else
+                {
+                    fatalError("Expected remote hostname after '\(option)'")
+                }
+
+                options.remote = remote
+
+            case let option:
+                fatalError("Unknown option '\(option)'")
+            }
+        }
+
+        return options
     }
 }
 
@@ -89,7 +112,7 @@ extension SwiftinitClient
     {
         try await self.http2.connect
         {
-            try await body(Connection.init(http2: $0))
+            try await body(Connection.init(http2: $0, to: self.http2.remote))
         }
     }
 }
@@ -113,11 +136,14 @@ extension SwiftinitClient
     {
         @usableFromInline internal
         let http2:HTTP2Client.Connection
+        @usableFromInline internal
+        let remote:String
 
         @inlinable internal
-        init(http2:HTTP2Client.Connection)
+        init(http2:HTTP2Client.Connection, to remote:String)
         {
             self.http2 = http2
+            self.remote = remote
         }
     }
 }
@@ -137,7 +163,7 @@ extension SwiftinitClient.Connection
             [
                 ":method": "GET",
                 ":scheme": "https",
-                ":authority": "swiftinit.org",
+                ":authority": self.remote,
                 ":path": endpoint,
 
                 "user-agent": "UnidocBuild",
@@ -159,7 +185,7 @@ extension SwiftinitClient.Connection
             case 301?:
                 if  let location:String = response.headers?["location"].first
                 {
-                    endpoint = String.init(location.trimmingPrefix("https://swiftinit.org"))
+                    endpoint = String.init(location.trimmingPrefix("https://\(self.remote)"))
                     continue following
                 }
             case _:

Sources/UnidocDB/Packages/UnidocDatabase.Graphs.swift

@@ -122,7 +122,7 @@ extension UnidocDatabase.Graphs
 }
 extension UnidocDatabase.Graphs
 {
-    public
+    @available(*, unavailable, message: "unused")
     func metadata(
         package:PackageIdentifier,
         limit:Int = 1,

Sources/UnidocDB/Packages/UnidocDatabase.swift

@@ -107,29 +107,6 @@ extension UnidocDatabase
         {
             (snapshot:Snapshot) in
 
-            // let origin:Volume.Origin? = try await
-            // {
-            //     switch $0
-            //     {
-            //     case let origin??:
-            //         return origin
-
-            //     case nil?:
-            //         //  We already tried to find the origin for this package, and it
-            //         //  didn't exist.
-            //         return nil
-
-            //     case nil:
-            //         let package:PackageRecord? = try await self.packages.find(
-            //             by: PackageRecord[.cell],
-            //             of: snapshot.package,
-            //             with: session)
-            //         let origin:Volume.Origin? = package?.repo?.origin
-            //         $0 = .some(origin)
-            //         return origin
-            //     }
-            // } (&origins[snapshot.package])
-
             let volume:Volume = try await self.link(snapshot, with: session)
 
             try await self.publish(volume, with: session)
@@ -202,9 +179,7 @@ extension UnidocDatabase
             case _:
                 fatalError("unimplemented")
             }
-            /// Standard library symbol graphs don’t come with hashes, so we can’t efficiently
-            /// “prove” that a particular edition has at least one symbol graph. But we don’t
-            /// need to query that in the first place.
+
             let placement:Editions.Placement = try await self.editions.register(
                 package: placement.coordinate,
                 version: semver,
@@ -241,7 +216,7 @@ extension UnidocDatabase
 }
 extension UnidocDatabase
 {
-    public
+    @available(*, unavailable, message: "unused")
     func _editions(of package:PackageIdentifier,
         with session:Mongo.Session) async throws -> [PackageEdition]
     {