Deprecating PostgresDataConvertible, PostgresMessageType (#313)

fabianfett · web-flow · commit c996d6256d2a · 2023-04-20T13:04:39.000+02:00
diff --git a/Sources/PostgresNIO/Data/PostgresData+Array.swift b/Sources/PostgresNIO/Data/PostgresData+Array.swift
@@ -1,14 +1,14 @@
 import NIOCore
 
 extension PostgresData {
-    public init<T>(array: [T])
-        where T: PostgresDataConvertible
-    {
+    @available(*, deprecated, message: "Use ``PostgresQuery`` and ``PostgresBindings`` instead.")
+    public init<T>(array: [T]) where T: PostgresDataConvertible {
         self.init(
             array: array.map { $0.postgresData },
             elementType: T.postgresDataType
         )
     }
+
     public init(array: [PostgresData?], elementType: PostgresDataType) {
         var buffer = ByteBufferAllocator().buffer(capacity: 0)
         // 0 if empty, 1 if not
@@ -46,9 +46,8 @@ extension PostgresData {
         )
     }
 
-    public func array<T>(of type: T.Type = T.self) -> [T]?
-        where T: PostgresDataConvertible
-    {
+    @available(*, deprecated, message: "Use ``PostgresRow`` and ``PostgresDecodable`` instead.")
+    public func array<T>(of type: T.Type = T.self) -> [T]? where T: PostgresDataConvertible {
         guard let array = self.array else {
             return nil
         }
@@ -114,6 +113,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Array: PostgresDataConvertible where Element: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         guard let arrayType = Element.postgresDataType.arrayType else {
diff --git a/Sources/PostgresNIO/Data/PostgresData+Bool.swift b/Sources/PostgresNIO/Data/PostgresData+Bool.swift
@@ -47,6 +47,7 @@ extension PostgresData: ExpressibleByBooleanLiteral {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Bool: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .bool
diff --git a/Sources/PostgresNIO/Data/PostgresData+Bytes.swift b/Sources/PostgresNIO/Data/PostgresData+Bytes.swift
@@ -21,6 +21,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Data: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .bytea
diff --git a/Sources/PostgresNIO/Data/PostgresData+Date.swift b/Sources/PostgresNIO/Data/PostgresData+Date.swift
@@ -36,6 +36,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Date: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .timestamptz
diff --git a/Sources/PostgresNIO/Data/PostgresData+Decimal.swift b/Sources/PostgresNIO/Data/PostgresData+Decimal.swift
@@ -16,6 +16,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Decimal: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .numeric
diff --git a/Sources/PostgresNIO/Data/PostgresData+Double.swift b/Sources/PostgresNIO/Data/PostgresData+Double.swift
@@ -34,6 +34,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Double: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .float8
diff --git a/Sources/PostgresNIO/Data/PostgresData+Float.swift b/Sources/PostgresNIO/Data/PostgresData+Float.swift
@@ -28,6 +28,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Float: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .float4
diff --git a/Sources/PostgresNIO/Data/PostgresData+Int.swift b/Sources/PostgresNIO/Data/PostgresData+Int.swift
@@ -183,6 +183,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Int: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType { .int8 }
 
@@ -198,6 +199,7 @@ extension Int: PostgresDataConvertible {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension UInt8: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType { .char }
 
@@ -213,6 +215,7 @@ extension UInt8: PostgresDataConvertible {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Int16: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType { .int2 }
 
@@ -228,6 +231,7 @@ extension Int16: PostgresDataConvertible {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Int32: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType { .int4 }
 
@@ -243,6 +247,7 @@ extension Int32: PostgresDataConvertible {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Int64: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType { .int8 }
 
diff --git a/Sources/PostgresNIO/Data/PostgresData+JSON.swift b/Sources/PostgresNIO/Data/PostgresData+JSON.swift
@@ -37,8 +37,10 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "This protocol is going to be replaced with ``PostgresEncodable`` and ``PostgresDecodable`` and conforming to ``Codable`` at the same time")
 public protocol PostgresJSONCodable: Codable, PostgresDataConvertible { }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension PostgresJSONCodable {
     public static var postgresDataType: PostgresDataType {
         return .json
diff --git a/Sources/PostgresNIO/Data/PostgresData+JSONB.swift b/Sources/PostgresNIO/Data/PostgresData+JSONB.swift
@@ -48,8 +48,10 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "This protocol is going to be replaced with ``PostgresEncodable`` and ``PostgresDecodable`` and conforming to ``Codable`` at the same time")
 public protocol PostgresJSONBCodable: Codable, PostgresDataConvertible { }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension PostgresJSONBCodable {
     public static var postgresDataType: PostgresDataType {
         return .jsonb
diff --git a/Sources/PostgresNIO/Data/PostgresData+Optional.swift b/Sources/PostgresNIO/Data/PostgresData+Optional.swift
@@ -1,3 +1,4 @@
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Optional: PostgresDataConvertible where Wrapped: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return Wrapped.postgresDataType
diff --git a/Sources/PostgresNIO/Data/PostgresData+RawRepresentable.swift b/Sources/PostgresNIO/Data/PostgresData+RawRepresentable.swift
@@ -1,3 +1,4 @@
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension RawRepresentable where Self.RawValue: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         RawValue.postgresDataType
diff --git a/Sources/PostgresNIO/Data/PostgresData+Set.swift b/Sources/PostgresNIO/Data/PostgresData+Set.swift
@@ -1,3 +1,4 @@
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension Set: PostgresDataConvertible where Element: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         [Element].postgresDataType
diff --git a/Sources/PostgresNIO/Data/PostgresData+String.swift b/Sources/PostgresNIO/Data/PostgresData+String.swift
@@ -94,6 +94,7 @@ extension PostgresData: ExpressibleByStringLiteral {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension String: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .text
diff --git a/Sources/PostgresNIO/Data/PostgresData+UUID.swift b/Sources/PostgresNIO/Data/PostgresData+UUID.swift
@@ -29,6 +29,7 @@ extension PostgresData {
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension UUID: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         return .uuid
diff --git a/Sources/PostgresNIO/Data/PostgresData.swift b/Sources/PostgresNIO/Data/PostgresData.swift
@@ -1,7 +1,7 @@
 import NIOCore
 import struct Foundation.UUID
 
-public struct PostgresData: Sendable, CustomStringConvertible, CustomDebugStringConvertible {
+public struct PostgresData: Sendable {
     public static var null: PostgresData {
         return .init(type: .null)
     }
@@ -26,7 +26,10 @@ public struct PostgresData: Sendable, CustomStringConvertible, CustomDebugString
         self.formatCode = formatCode
         self.value = value
     }
-    
+}
+
+@available(*, deprecated, message: "Deprecating conformance to `CustomStringConvertible` as a first step of deprecating `PostgresData`. Please use `PostgresBindings` or `PostgresCell` instead.")
+extension PostgresData: CustomStringConvertible {
     public var description: String {
         guard var value = self.value else {
             return "<null>"
@@ -93,12 +96,16 @@ public struct PostgresData: Sendable, CustomStringConvertible, CustomDebugString
             return "\(raw) (\(self.type))"
         }
     }
+}
 
+@available(*, deprecated, message: "Deprecating conformance to `CustomDebugStringConvertible` as a first step of deprecating `PostgresData`. Please use `PostgresBindings` or `PostgresCell` instead.")
+extension PostgresData: CustomDebugStringConvertible {
     public var debugDescription: String {
         return self.description
     }
 }
 
+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
 extension PostgresData: PostgresDataConvertible {
     public static var postgresDataType: PostgresDataType {
         fatalError("PostgresData cannot be statically represented as a single data type")
diff --git a/Sources/PostgresNIO/Data/PostgresDataConvertible.swift b/Sources/PostgresNIO/Data/PostgresDataConvertible.swift
@@ -1,5 +1,6 @@
 import Foundation
 
+@available(*, deprecated, message: "This protocol is going to be replaced with ``PostgresEncodable`` and ``PostgresDecodable``")
 public protocol PostgresDataConvertible {
     static var postgresDataType: PostgresDataType { get }
     init?(postgresData: PostgresData)
diff --git a/Sources/PostgresNIO/Data/PostgresRow.swift b/Sources/PostgresNIO/Data/PostgresRow.swift
@@ -265,6 +265,7 @@ extension PostgresRandomAccessRow {
 // MARK: Deprecated API
 
 extension PostgresRow {
+    @available(*, deprecated, message: "Will be removed from public API.")
     public var rowDescription: PostgresMessage.RowDescription {
         let fields = self.columns.map { column in
             PostgresMessage.RowDescription.Field(
@@ -280,6 +281,7 @@ extension PostgresRow {
         return PostgresMessage.RowDescription(fields: fields)
     }
 
+    @available(*, deprecated, message: "Iterate the cells on `PostgresRow` instead.")
     public var dataRow: PostgresMessage.DataRow {
         let columns = self.data.map {
             PostgresMessage.DataRow.Column(value: $0)
diff --git a/Sources/PostgresNIO/Deprecated/PostgresMessage+SASLResponse.swift b/Sources/PostgresNIO/Deprecated/PostgresMessage+SASLResponse.swift
@@ -30,35 +30,13 @@ extension PostgresMessage {
 
 extension PostgresMessage {
     /// SASL initial challenge response message sent by the client.
-    public struct SASLInitialResponse: PostgresMessageType {
-        public static var identifier: PostgresMessage.Identifier {
-            return .saslInitialResponse
-        }
-        
+    @available(*, deprecated, message: "Will be removed from public API")
+    public struct SASLInitialResponse {
         public let mechanism: String
         public let initialData: [UInt8]
         
-        public static func parse(from buffer: inout ByteBuffer) throws -> PostgresMessage.SASLInitialResponse {
-            guard let mechanism = buffer.readNullTerminatedString() else {
-                throw PostgresError.protocol("Could not parse SASL mechanism from initial response message")
-            }
-            guard let dataLength = buffer.readInteger(as: Int32.self) else {
-                throw PostgresError.protocol("Could not parse SASL initial data length from initial response message")
-            }
-            
-            var actualData: [UInt8] = []
-            
-            if dataLength != -1 {
-                guard let data = buffer.readBytes(length: Int(dataLength)) else {
-                    throw PostgresError.protocol("Could not parse SASL initial data from initial response message")
-                }
-                actualData = data
-            }
-            return SASLInitialResponse(mechanism: mechanism, initialData: actualData)
-        }
-        
         public func serialize(into buffer: inout ByteBuffer) throws {
-            buffer.writeNullTerminatedString(mechanism)
+            buffer.writeNullTerminatedString(self.mechanism)
             if initialData.count > 0 {
                 buffer.writeInteger(Int32(initialData.count), as: Int32.self) // write(array:) writes Int16, which is incorrect here
                 buffer.writeBytes(initialData)
@@ -72,3 +50,29 @@ extension PostgresMessage {
         }
     }
 }
+
+@available(*, deprecated, message: "Deprecating conformance to `PostgresMessageType` since it is deprecated.")
+extension PostgresMessage.SASLInitialResponse: PostgresMessageType {
+    public static var identifier: PostgresMessage.Identifier {
+        return .saslInitialResponse
+    }
+
+    public static func parse(from buffer: inout ByteBuffer) throws -> Self {
+        guard let mechanism = buffer.readNullTerminatedString() else {
+            throw PostgresError.protocol("Could not parse SASL mechanism from initial response message")
+        }
+        guard let dataLength = buffer.readInteger(as: Int32.self) else {
+            throw PostgresError.protocol("Could not parse SASL initial data length from initial response message")
+        }
+
+        var actualData: [UInt8] = []
+
+        if dataLength != -1 {
+            guard let data = buffer.readBytes(length: Int(dataLength)) else {
+                throw PostgresError.protocol("Could not parse SASL initial data from initial response message")
+            }
+            actualData = data
+        }
+        return .init(mechanism: mechanism, initialData: actualData)
+    }
+}
diff --git a/Sources/PostgresNIO/Docs.docc/index.md b/Sources/PostgresNIO/Docs.docc/index.md
@@ -45,6 +45,7 @@ Features:
 - ``PostgresJSONEncoder``
 - ``PostgresJSONDecoder``
 - ``PostgresDataType``
+- ``PostgresFormat``
 - ``PostgresNumeric``
 
 ### Notifications
@@ -72,8 +73,11 @@ removed from the public API with the next major release.
 - ``PostgresRequest``
 - ``PostgresMessage``
 - ``PostgresMessageType``
+- ``PostgresFormatCode``
 - ``SASLAuthenticationManager``
 - ``SASLAuthenticationMechanism``
+- ``SASLAuthenticationError``
+- ``SASLAuthenticationStepResult``
 
 [SwiftNIO]: https://github.com/apple/swift-nio
 [SwiftLog]: https://github.com/apple/swift-log
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+0.swift b/Sources/PostgresNIO/Message/PostgresMessage+0.swift
@@ -2,9 +2,11 @@ import NIOCore
 
 /// A frontend or backend Postgres message.
 public struct PostgresMessage: Equatable {
+    @available(*, deprecated, message: "Will be removed from public API.")
     public var identifier: Identifier
     public var data: ByteBuffer
 
+    @available(*, deprecated, message: "Will be removed from public API.")
     public init<Data>(identifier: Identifier, bytes: Data)
         where Data: Sequence, Data.Element == UInt8
     {
@@ -13,6 +15,7 @@ public struct PostgresMessage: Equatable {
         self.init(identifier: identifier, data: buffer)
     }
 
+    @available(*, deprecated, message: "Will be removed from public API.")
     public init(identifier: Identifier, data: ByteBuffer) {
         self.identifier = identifier
         self.data = data
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+BackendKeyData.swift b/Sources/PostgresNIO/Message/PostgresMessage+BackendKeyData.swift
@@ -3,26 +3,29 @@ import NIOCore
 extension PostgresMessage {
     /// Identifies the message as cancellation key data.
     /// The frontend must save these values if it wishes to be able to issue CancelRequest messages later.
-    public struct BackendKeyData: PostgresMessageType {
-        public static var identifier: PostgresMessage.Identifier {
-            .backendKeyData
-        }
-        
-        /// Parses an instance of this message type from a byte buffer.
-        public static func parse(from buffer: inout ByteBuffer) throws -> BackendKeyData {
-            guard let processID = buffer.readInteger(as: Int32.self) else {
-                throw PostgresError.protocol("Could not parse process id from backend key data")
-            }
-            guard let secretKey = buffer.readInteger(as: Int32.self) else {
-                throw PostgresError.protocol("Could not parse secret key from backend key data")
-            }
-            return .init(processID: processID, secretKey: secretKey)
-        }
-        
+    public struct BackendKeyData {
         /// The process ID of this backend.
         public var processID: Int32
         
         /// The secret key of this backend.
         public var secretKey: Int32
     }
 }
+
+@available(*, deprecated, message: "Deprecating conformance to `PostgresMessageType` since it is deprecated.")
+extension PostgresMessage.BackendKeyData: PostgresMessageType {
+    public static var identifier: PostgresMessage.Identifier {
+        .backendKeyData
+    }
+
+    /// Parses an instance of this message type from a byte buffer.
+    public static func parse(from buffer: inout ByteBuffer) throws -> Self {
+        guard let processID = buffer.readInteger(as: Int32.self) else {
+            throw PostgresError.protocol("Could not parse process id from backend key data")
+        }
+        guard let secretKey = buffer.readInteger(as: Int32.self) else {
+            throw PostgresError.protocol("Could not parse secret key from backend key data")
+        }
+        return .init(processID: processID, secretKey: secretKey)
+    }
+}
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+DataRow.swift b/Sources/PostgresNIO/Message/PostgresMessage+DataRow.swift
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+Error.swift b/Sources/PostgresNIO/Message/PostgresMessage+Error.swift
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+Identifier.swift b/Sources/PostgresNIO/Message/PostgresMessage+Identifier.swift
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+NotificationResponse.swift b/Sources/PostgresNIO/Message/PostgresMessage+NotificationResponse.swift
diff --git a/Sources/PostgresNIO/Message/PostgresMessage+RowDescription.swift b/Sources/PostgresNIO/Message/PostgresMessage+RowDescription.swift
diff --git a/Sources/PostgresNIO/Message/PostgresMessageType.swift b/Sources/PostgresNIO/Message/PostgresMessageType.swift
diff --git a/Tests/IntegrationTests/PerformanceTests.swift b/Tests/IntegrationTests/PerformanceTests.swift
diff --git a/Tests/IntegrationTests/PostgresNIOTests.swift b/Tests/IntegrationTests/PostgresNIOTests.swift
diff --git a/Tests/PostgresNIOTests/Data/PostgresData+JSONTests.swift b/Tests/PostgresNIOTests/Data/PostgresData+JSONTests.swift

Original file line number	Diff line number	Diff line change
`@@ -1,14 +1,14 @@`
`1`	`1`	`import NIOCore`
`2`	`2`
`3`	`3`	`extension PostgresData {`
`4`		`- public init<T>(array: [T])`
`5`		`- where T: PostgresDataConvertible`
`6`		`- {`
	`4`	+ @available(*, deprecated, message: "Use ``PostgresQuery`` and ``PostgresBindings`` instead.")
	`5`	`+ public init<T>(array: [T]) where T: PostgresDataConvertible {`
`7`	`6`	`self.init(`
`8`	`7`	`array: array.map { $0.postgresData },`
`9`	`8`	`elementType: T.postgresDataType`
`10`	`9`	`)`
`11`	`10`	`}`
	`11`	`+`
`12`	`12`	`public init(array: [PostgresData?], elementType: PostgresDataType) {`
`13`	`13`	`var buffer = ByteBufferAllocator().buffer(capacity: 0)`
`14`	`14`	`// 0 if empty, 1 if not`
`@@ -46,9 +46,8 @@ extension PostgresData {`
`46`	`46`	`)`
`47`	`47`	`}`
`48`	`48`
`49`		`- public func array<T>(of type: T.Type = T.self) -> [T]?`
`50`		`- where T: PostgresDataConvertible`
`51`		`- {`
	`49`	+ @available(*, deprecated, message: "Use ``PostgresRow`` and ``PostgresDecodable`` instead.")
	`50`	`+ public func array<T>(of type: T.Type = T.self) -> [T]? where T: PostgresDataConvertible {`
`52`	`51`	`guard let array = self.array else {`
`53`	`52`	`return nil`
`54`	`53`	`}`
`@@ -114,6 +113,7 @@ extension PostgresData {`
`114`	`113`	`}`
`115`	`114`	`}`
`116`	`115`
	`116`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`117`	`117`	`extension Array: PostgresDataConvertible where Element: PostgresDataConvertible {`
`118`	`118`	`public static var postgresDataType: PostgresDataType {`
`119`	`119`	`guard let arrayType = Element.postgresDataType.arrayType else {`
Original file line number	Diff line number	Diff line change
`@@ -47,6 +47,7 @@ extension PostgresData: ExpressibleByBooleanLiteral {`
`47`	`47`	`}`
`48`	`48`	`}`
`49`	`49`
	`50`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`50`	`51`	`extension Bool: PostgresDataConvertible {`
`51`	`52`	`public static var postgresDataType: PostgresDataType {`
`52`	`53`	`return .bool`
Original file line number	Diff line number	Diff line change
`@@ -21,6 +21,7 @@ extension PostgresData {`
`21`	`21`	`}`
`22`	`22`	`}`
`23`	`23`
	`24`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`24`	`25`	`extension Data: PostgresDataConvertible {`
`25`	`26`	`public static var postgresDataType: PostgresDataType {`
`26`	`27`	`return .bytea`
Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,7 @@ extension PostgresData {`
`36`	`36`	`}`
`37`	`37`	`}`
`38`	`38`
	`39`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`39`	`40`	`extension Date: PostgresDataConvertible {`
`40`	`41`	`public static var postgresDataType: PostgresDataType {`
`41`	`42`	`return .timestamptz`
Original file line number	Diff line number	Diff line change
`@@ -16,6 +16,7 @@ extension PostgresData {`
`16`	`16`	`}`
`17`	`17`	`}`
`18`	`18`
	`19`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`19`	`20`	`extension Decimal: PostgresDataConvertible {`
`20`	`21`	`public static var postgresDataType: PostgresDataType {`
`21`	`22`	`return .numeric`
Original file line number	Diff line number	Diff line change
`@@ -34,6 +34,7 @@ extension PostgresData {`
`34`	`34`	`}`
`35`	`35`	`}`
`36`	`36`
	`37`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`37`	`38`	`extension Double: PostgresDataConvertible {`
`38`	`39`	`public static var postgresDataType: PostgresDataType {`
`39`	`40`	`return .float8`
Original file line number	Diff line number	Diff line change
`@@ -28,6 +28,7 @@ extension PostgresData {`
`28`	`28`	`}`
`29`	`29`	`}`
`30`	`30`
	`31`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`31`	`32`	`extension Float: PostgresDataConvertible {`
`32`	`33`	`public static var postgresDataType: PostgresDataType {`
`33`	`34`	`return .float4`
Original file line number	Diff line number	Diff line change
`@@ -183,6 +183,7 @@ extension PostgresData {`
`183`	`183`	`}`
`184`	`184`	`}`
`185`	`185`
	`186`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`186`	`187`	`extension Int: PostgresDataConvertible {`
`187`	`188`	`public static var postgresDataType: PostgresDataType { .int8 }`
`188`	`189`
`@@ -198,6 +199,7 @@ extension Int: PostgresDataConvertible {`
`198`	`199`	`}`
`199`	`200`	`}`
`200`	`201`
	`202`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`201`	`203`	`extension UInt8: PostgresDataConvertible {`
`202`	`204`	`public static var postgresDataType: PostgresDataType { .char }`
`203`	`205`
`@@ -213,6 +215,7 @@ extension UInt8: PostgresDataConvertible {`
`213`	`215`	`}`
`214`	`216`	`}`
`215`	`217`
	`218`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`216`	`219`	`extension Int16: PostgresDataConvertible {`
`217`	`220`	`public static var postgresDataType: PostgresDataType { .int2 }`
`218`	`221`
`@@ -228,6 +231,7 @@ extension Int16: PostgresDataConvertible {`
`228`	`231`	`}`
`229`	`232`	`}`
`230`	`233`
	`234`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`231`	`235`	`extension Int32: PostgresDataConvertible {`
`232`	`236`	`public static var postgresDataType: PostgresDataType { .int4 }`
`233`	`237`
`@@ -243,6 +247,7 @@ extension Int32: PostgresDataConvertible {`
`243`	`247`	`}`
`244`	`248`	`}`
`245`	`249`
	`250`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`246`	`251`	`extension Int64: PostgresDataConvertible {`
`247`	`252`	`public static var postgresDataType: PostgresDataType { .int8 }`
`248`	`253`
Original file line number	Diff line number	Diff line change
`@@ -37,8 +37,10 @@ extension PostgresData {`
`37`	`37`	`}`
`38`	`38`	`}`
`39`	`39`
	`40`	+@available(*, deprecated, message: "This protocol is going to be replaced with ``PostgresEncodable`` and ``PostgresDecodable`` and conforming to ``Codable`` at the same time")
`40`	`41`	`public protocol PostgresJSONCodable: Codable, PostgresDataConvertible { }`
`41`	`42`
	`43`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`42`	`44`	`extension PostgresJSONCodable {`
`43`	`45`	`public static var postgresDataType: PostgresDataType {`
`44`	`46`	`return .json`
Original file line number	Diff line number	Diff line change
`@@ -48,8 +48,10 @@ extension PostgresData {`
`48`	`48`	`}`
`49`	`49`	`}`
`50`	`50`
	`51`	+@available(*, deprecated, message: "This protocol is going to be replaced with ``PostgresEncodable`` and ``PostgresDecodable`` and conforming to ``Codable`` at the same time")
`51`	`52`	`public protocol PostgresJSONBCodable: Codable, PostgresDataConvertible { }`
`52`	`53`
	`54`	+@available(*, deprecated, message: "Deprecating conformance to `PostgresDataConvertible`, since it is deprecated.")
`53`	`55`	`extension PostgresJSONBCodable {`
`54`	`56`	`public static var postgresDataType: PostgresDataType {`
`55`	`57`	`return .jsonb`