Fix FreeBSD build and test (#1149)

Author: michael-yuji

Sources/SwiftDocC/Benchmark/Benchmark.swift

@@ -46,6 +46,8 @@ public class Benchmark: Encodable {
     public let platform = "Linux"
     #elseif os(Android)
     public let platform = "Android"
+    #elseif os(FreeBSD)
+    public let platform = "FreeBSD"
     #else
     public let platform = "unsupported"
     #endif

Sources/SwiftDocC/Benchmark/Metrics/PeakMemory.swift

@@ -67,6 +67,15 @@ extension Benchmark {
             ) else { return nil }
             return Int64(pmcStats.PeakWorkingSetSize)
         }
+        #elseif os(FreeBSD)
+        private static func peakMemory() -> Int64? {
+            var usage = rusage()
+            if (getrusage(RUSAGE_SELF, &usage) == -1) {
+                return nil
+            } else {
+                return Int64(usage.ru_maxrss * 1024)
+            }
+        }
         #endif
 
         public var result: MetricValue? {

Sources/SwiftDocC/Infrastructure/External Data/OutOfProcessReferenceResolver.swift

@@ -291,7 +291,7 @@ private class LongRunningService: ExternalLinkResolving {
 /// This private class is only used by the ``OutOfProcessReferenceResolver`` and shouldn't be used for general communication with other processes.
 private class LongRunningProcess: ExternalLinkResolving {
 
-    #if os(macOS) || os(Linux) || os(Android)
+    #if os(macOS) || os(Linux) || os(Android) || os(FreeBSD)
     private let process: Process
 
     init(location: URL, errorOutputHandler: @escaping (String) -> Void) throws {

Sources/SwiftDocC/Model/Rendering/RenderContext.swift

@@ -61,7 +61,7 @@ public struct RenderContext {
             )
         }
 
-        #if os(macOS) || os(iOS) || os(Android) || os(Windows)
+        #if os(macOS) || os(iOS) || os(Android) || os(Windows) || os(FreeBSD)
         // Concurrently render content on macOS/iOS, Windows & Android
         let results: [(reference: ResolvedTopicReference, content: RenderReferenceStore.TopicContent)] = references.concurrentPerform { reference, results in
             results.append((reference, renderContentFor(reference)))

Sources/SwiftDocC/Utility/FoundationExtensions/AutoreleasepoolShim.swift

@@ -8,7 +8,7 @@
  See https://swift.org/CONTRIBUTORS.txt for Swift project authors
 */
 
-#if os(Linux) || os(Android) || os(Windows)
+#if os(Linux) || os(Android) || os(Windows) || os(FreeBSD)
 /// A shim for non-ObjC targets that runs the given block of code.
 ///
 /// The existence of this shim allows you the use of auto-release pools to optimize memory footprint on Darwin platforms while maintaining

Sources/SwiftDocC/Utility/Synchronization.swift

@@ -35,6 +35,9 @@ public class Synchronized<Value> {
     #elseif os(Linux) || os(Android)
     /// A lock type appropriate for the current platform.
     var lock: UnsafeMutablePointer<pthread_mutex_t>
+    #elseif os(FreeBSD)
+    /// A lock type appropriate for the current platform.
+    var lock: UnsafeMutablePointer<pthread_mutex_t?>
     #elseif os(Windows)
     var lock: UnsafeMutablePointer<SRWLOCK>
     #else
@@ -53,6 +56,10 @@ public class Synchronized<Value> {
         lock = UnsafeMutablePointer<pthread_mutex_t>.allocate(capacity: 1)
         lock.initialize(to: pthread_mutex_t())
         pthread_mutex_init(lock, nil)
+        #elseif os(FreeBSD)
+        lock = UnsafeMutablePointer<pthread_mutex_t?>.allocate(capacity: 1)
+        lock.initialize(to: nil)
+        pthread_mutex_init(lock, nil)
         #elseif os(Windows)
         lock = UnsafeMutablePointer<SRWLOCK>.allocate(capacity: 1)
         InitializeSRWLock(lock)
@@ -77,6 +84,9 @@ public class Synchronized<Value> {
         #elseif os(Linux) || os(Android)
         pthread_mutex_lock(lock)
         defer { pthread_mutex_unlock(lock) }
+        #elseif os(FreeBSD)
+        pthread_mutex_lock(lock)
+        defer { pthread_mutex_unlock(lock) }
         #elseif os(Windows)
         AcquireSRWLockExclusive(lock)
         defer { ReleaseSRWLockExclusive(lock) }
@@ -113,6 +123,9 @@ extension Lock {
         #elseif os(Linux) || os(Android)
         pthread_mutex_lock(lock)
         defer { pthread_mutex_unlock(lock) }
+        #elseif os(FreeBSD)
+        pthread_mutex_lock(lock)
+        defer { pthread_mutex_unlock(lock) }
         #elseif os(Windows)
         AcquireSRWLockExclusive(lock)
         defer { ReleaseSRWLockExclusive(lock) }

Sources/SwiftDocCUtilities/Utility/DirectoryMonitor.swift

@@ -11,7 +11,7 @@
 import Foundation
 import SwiftDocC
 
-#if !os(Linux) && !os(Android) && !os(Windows)
+#if !os(Linux) && !os(Android) && !os(Windows) && !os(FreeBSD)
 import Darwin
 
 /// A throttle object to filter events that come too fast.

Sources/SwiftDocCUtilities/Utility/Signal.swift

@@ -25,6 +25,8 @@ public struct Signal {
         signalAction.__sigaction_handler = unsafeBitCast(callback, to: sigaction.__Unnamed_union___sigaction_handler.self)
         #elseif os(Android)
         signalAction.sa_handler = callback
+        #elseif os(FreeBSD)
+        signalAction.__sigaction_u.__sa_handler = callback
         #else
         signalAction.__sigaction_u = unsafeBitCast(callback, to: __sigaction_u.self)
         #endif

Sources/docc/main.swift

@@ -8,7 +8,7 @@
  See https://swift.org/CONTRIBUTORS.txt for Swift project authors
 */
 
-#if os(macOS) || os(Linux) || os(Android) || os(Windows)
+#if os(macOS) || os(Linux) || os(Android) || os(Windows) || os(FreeBSD)
 import SwiftDocCUtilities
 
 await Task {

Tests/SwiftDocCTests/Servers/DocumentationSchemeHandlerTests.swift

@@ -24,7 +24,7 @@ class DocumentationSchemeHandlerTests: XCTestCase {
         forResource: "LegacyBundle_DoNotUseInNewTests", withExtension: "docc", subdirectory: "Test Bundles")!
 
     func testDocumentationSchemeHandler() {
-        #if !os(Linux) && !os(Android) && !os(Windows)
+        #if !os(Linux) && !os(Android) && !os(Windows) && !os(FreeBSD)
         let topicSchemeHandler = DocumentationSchemeHandler(withTemplateURL: templateURL)
 
         let request = URLRequest(url:  baseURL.appendingPathComponent("/images/figure1.jpg"))
@@ -50,7 +50,7 @@ class DocumentationSchemeHandlerTests: XCTestCase {
     }
 
     func testSetData() {
-        #if !os(Linux) && !os(Android) && !os(Windows)
+        #if !os(Linux) && !os(Android) && !os(Windows) && !os(FreeBSD)
         let topicSchemeHandler = DocumentationSchemeHandler(withTemplateURL: templateURL)
 
         let data = "hello!".data(using: .utf8)!