2424/// A type should conform to this protocol if it can be represented as a
2525/// sequence of bytes that would be diagnostically useful if a test fails. If a
2626/// type cannot conform directly to this protocol (such as a non-final class or
27- /// a type declared in a third-party module), you can create a container type
28- /// that conforms to ``AttachableContainer`` to act as a proxy.
29- @_spi ( Experimental)
27+ /// a type declared in a third-party module), you can create a wrapper type that
28+ /// conforms to ``AttachableWrapper`` to act as a proxy.
29+ ///
30+ /// @Metadata {
31+ /// @Available(Swift, introduced: 6.2)
32+ /// }
3033public protocol Attachable : ~ Copyable {
3134 /// An estimate of the number of bytes of memory needed to store this value as
3235 /// an attachment.
@@ -42,6 +45,10 @@ public protocol Attachable: ~Copyable {
4245 ///
4346 /// - Complexity: O(1) unless `Self` conforms to `Collection`, in which case
4447 /// up to O(_n_) where _n_ is the length of the collection.
48+ ///
49+ /// @Metadata {
50+ /// @Available(Swift, introduced: 6.2)
51+ /// }
4552 var estimatedAttachmentByteCount : Int ? { get }
4653
4754 /// Call a function and pass a buffer representing this instance to it.
@@ -64,6 +71,10 @@ public protocol Attachable: ~Copyable {
6471 /// the buffer to contain an image in PNG format, JPEG format, etc., but it
6572 /// would not be idiomatic for the buffer to contain a textual description of
6673 /// the image.
74+ ///
75+ /// @Metadata {
76+ /// @Available(Swift, introduced: 6.2)
77+ /// }
6778 borrowing func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R
6879
6980 /// Generate a preferred name for the given attachment.
@@ -80,6 +91,10 @@ public protocol Attachable: ~Copyable {
8091 /// when adding `attachment` to a test report or persisting it to storage. The
8192 /// default implementation of this function returns `suggestedName` without
8293 /// any changes.
94+ ///
95+ /// @Metadata {
96+ /// @Available(Swift, introduced: 6.2)
97+ /// }
8398 borrowing func preferredName( for attachment: borrowing Attachment < Self > , basedOn suggestedName: String ) -> String
8499}
85100
@@ -119,28 +134,24 @@ extension Attachable where Self: StringProtocol {
119134
120135// Implement the protocol requirements for byte arrays and buffers so that
121136// developers can attach raw data when needed.
122- @_spi ( Experimental)
123137extension Array < UInt8 > : Attachable {
124138 public func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R {
125139 try withUnsafeBytes ( body)
126140 }
127141}
128142
129- @_spi ( Experimental)
130143extension ContiguousArray < UInt8 > : Attachable {
131144 public func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R {
132145 try withUnsafeBytes ( body)
133146 }
134147}
135148
136- @_spi ( Experimental)
137149extension ArraySlice < UInt8 > : Attachable {
138150 public func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R {
139151 try withUnsafeBytes ( body)
140152 }
141153}
142154
143- @_spi ( Experimental)
144155extension String : Attachable {
145156 public func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R {
146157 var selfCopy = self
@@ -150,7 +161,6 @@ extension String: Attachable {
150161 }
151162}
152163
153- @_spi ( Experimental)
154164extension Substring : Attachable {
155165 public func withUnsafeBytes< R> ( for attachment: borrowing Attachment < Self > , _ body: ( UnsafeRawBufferPointer ) throws -> R ) throws -> R {
156166 var selfCopy = self
0 commit comments