container/Sources/ContainerizationOS/URL+Extensions.swift

//===----------------------------------------------------------------------===//
// Copyright © 2025 Apple Inc. and the containerization project authors. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//   https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//===----------------------------------------------------------------------===//

import Foundation

/// The `resolvingSymlinksInPath` method of the `URL` struct does not resolve the symlinks
/// for directories under `/private` which include`tmp`, `var` and `etc`
/// hence adding a method to build up on the existing `resolvingSymlinksInPath` that prepends `/private` to those paths
extension URL {
    /// returns the unescaped absolutePath of a URL joined by separator
    func absolutePath(_ separator: String = "/") -> String {
        self.pathComponents
            .joined(separator: separator)
            .dropFirst("/".count)
            .description
    }

    public func resolvingSymlinksInPathWithPrivate() -> URL {
        let url = self.resolvingSymlinksInPath()
        #if os(macOS)
        let parts = url.pathComponents
        if parts.count > 1 {
            if (parts.first == "/") && ["tmp", "var", "etc"].contains(parts[1]) {
                if let resolved = NSURL.fileURL(withPathComponents: ["/", "private"] + parts[1...]) {
                    return resolved
                }
            }
        }
        #endif
        return url
    }

    public var isDirectory: Bool {
        (try? resourceValues(forKeys: [.isDirectoryKey]))?.isDirectory == true
    }

    public var isSymlink: Bool {
        (try? resourceValues(forKeys: [.isSymbolicLinkKey]))?.isSymbolicLink == true
    }
}