File: RegistryReleaseMetadata.swift

package info (click to toggle)
swiftlang 6.0.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,519,992 kB
  • sloc: cpp: 9,107,863; ansic: 2,040,022; asm: 1,135,751; python: 296,500; objc: 82,456; f90: 60,502; lisp: 34,951; pascal: 19,946; sh: 18,133; perl: 7,482; ml: 4,937; javascript: 4,117; makefile: 3,840; awk: 3,535; xml: 914; fortran: 619; cs: 573; ruby: 573
file content (118 lines) | stat: -rw-r--r-- 3,926 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift open source project
//
// Copyright (c) 2023 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See http://swift.org/LICENSE.txt for license information
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//

import struct Basics.SourceControlURL
import struct Foundation.URL
import struct TSCUtility.Version


public struct RegistryReleaseMetadata: Hashable {
    public let source: Source
    public let metadata: Metadata
    public let signature: RegistrySignature?

    public init(
        source: RegistryReleaseMetadata.Source,
        metadata: RegistryReleaseMetadata.Metadata,
        signature: RegistrySignature?
    ) {
        self.source = source
        self.metadata = metadata
        self.signature = signature
    }

    /// Metadata of the given release, provided by the registry.
    public struct Metadata: Hashable {
        public let author: Author?
        public let description: String?
        public let licenseURL: URL?
        public let readmeURL: URL?
        public let scmRepositoryURLs: [SourceControlURL]?

        public init(
            author: RegistryReleaseMetadata.Metadata.Author? = nil,
            description: String? = nil,
            licenseURL: URL? = nil,
            readmeURL: URL? = nil,
            scmRepositoryURLs: [SourceControlURL]?
        ) {
            self.author = author
            self.description = description
            self.licenseURL = licenseURL
            self.readmeURL = readmeURL
            self.scmRepositoryURLs = scmRepositoryURLs
        }

        public struct Author: Hashable {
            public let name: String
            public let emailAddress: String?
            public let description: String?
            public let url: URL?
            public let organization: Organization?

            public init(
                name: String,
                emailAddress: String? = nil,
                description: String? = nil,
                url: URL? = nil,
                organization: RegistryReleaseMetadata.Metadata.Organization?
            ) {
                self.name = name
                self.emailAddress = emailAddress
                self.description = description
                self.url = url
                self.organization = organization
            }
        }

        public struct Organization: Hashable {
            public let name: String
            public let emailAddress: String?
            public let description: String?
            public let url: URL?

            public init(name: String, emailAddress: String? = nil, description: String? = nil, url: URL? = nil) {
                self.name = name
                self.emailAddress = emailAddress
                self.description = description
                self.url = url
            }
        }
    }

    /// Information from the signing certificate.
    public struct RegistrySignature: Hashable, Codable {
        public let signedBy: SigningEntity?
        public let format: String
        public let value: [UInt8]

        public init(
            signedBy: SigningEntity?,
            format: String,
            value: [UInt8]
        ) {
            self.signedBy = signedBy
            self.format = format
            self.value = value
        }
    }

    public enum SigningEntity: Codable, Hashable, Sendable {
        case recognized(type: String, commonName: String?, organization: String?, identity: String?)
        case unrecognized(commonName: String?, organization: String?)
    }
    
    /// Information about the source of the release.
    public enum Source: Hashable {
        case registry(URL)
    }
}