Identifier Debugger Support

Sources/CodableDatastore/Persistence/Disk Persistence/Datastore/DatastoreIndex.swift

@@ -16,6 +16,10 @@ import Bytes
 
 typealias DatastoreIndexIdentifier = TypedIdentifier<DiskPersistence<ReadOnly>.Datastore.Index>
 
+@DebugDescription extension DatastoreIndexIdentifier {
+    var debugDescription: String { "DatastoreIndexIdentifier(\(rawValue))" }
+}
+
 extension DiskPersistence.Datastore {
     actor Index: Identifiable {
         let datastore: DiskPersistence<AccessMode>.Datastore

Sources/CodableDatastore/Persistence/Disk Persistence/Datastore/DatastoreIndexManifest.swift

@@ -13,6 +13,10 @@ import Foundation
 
 typealias DatastoreIndexManifestIdentifier = DatedIdentifier<DatastoreIndexManifest>
 
+@DebugDescription extension DatastoreIndexManifestIdentifier {
+    var debugDescription: String { "DatastoreIndexManifestIdentifier(\(rawValue))" }
+}
+
 struct DatastoreIndexManifest: Equatable, Identifiable {
     /// The identifier for this manifest.
     var id: DatastoreIndexManifestIdentifier

Sources/CodableDatastore/Persistence/Disk Persistence/Datastore/DatastorePage.swift

@@ -13,6 +13,10 @@ import Foundation
 
 typealias DatastorePageIdentifier = DatedIdentifier<DiskPersistence<ReadOnly>.Datastore.Page>
 
+@DebugDescription extension DatastorePageIdentifier {
+    var debugDescription: String { "DatastorePageIdentifier(\(rawValue))" }
+}
+
 extension DiskPersistence.Datastore {
     actor Page: Identifiable {
         let datastore: DiskPersistence<AccessMode>.Datastore

Sources/CodableDatastore/Persistence/Disk Persistence/Datastore/DatastoreRoot.swift

@@ -11,6 +11,10 @@ import Foundation
 
 typealias DatastoreRootIdentifier = DatedIdentifier<DiskPersistence<ReadOnly>.Datastore.RootObject>
 
+@DebugDescription extension DatastoreRootIdentifier {
+    var debugDescription: String { "DatastoreRootIdentifier(\(rawValue))" }
+}
+
 /// A reference to a particular root within a datastore.
 ///
 /// Prior to version 0.4 (2024-10-11), only the root ID was stored in the snapshot iteration manifest's root file, which meant one would need to guess which datastore it belonged to. This type thus tries to decode both a single ``DatastoreRootIdentifier`` and a pair of ``DatastoreIdentifier`` and ``DatastoreRootIdentifier``s.

Sources/CodableDatastore/Persistence/Disk Persistence/Datastore/PersistenceDatastore.swift

@@ -11,6 +11,10 @@ import Foundation
 
 typealias DatastoreIdentifier = TypedIdentifier<DiskPersistence<ReadOnly>.Datastore>
 
+@DebugDescription extension DatastoreIdentifier {
+    var debugDescription: String { "DatastoreIdentifier(\(rawValue))" }
+}
+
 struct WeakValue<T: AnyObject> {
     weak var value: T?
 

Sources/CodableDatastore/Persistence/Disk Persistence/Snapshot/Snapshot.swift

@@ -12,6 +12,10 @@ import QuestionableConcurrency
 
 typealias SnapshotIdentifier = DatedIdentifier<Snapshot<ReadOnly>>
 
+@DebugDescription extension SnapshotIdentifier {
+    var debugDescription: String { "SnapshotIdentifier(\(rawValue))" }
+}
+
 /// A type that manages access to a snapshot on disk.
 actor Snapshot<AccessMode: _AccessMode> {
     /// The identifier of the snapshot.

Sources/CodableDatastore/Persistence/Disk Persistence/Snapshot/SnapshotIteration.swift

@@ -11,6 +11,10 @@ import Foundation
 
 typealias SnapshotIterationIdentifier = DatedIdentifier<SnapshotIteration>
 
+@DebugDescription extension SnapshotIterationIdentifier {
+    var debugDescription: String { "SnapshotIterationIdentifier(\(rawValue))" }
+}
+
 /// Versions supported by ``DiskPersisitence``.
 ///
 /// These are used when dealing with format changes at the library level.

Sources/CodableDatastore/Persistence/Disk Persistence/TypedIdentifier.swift

@@ -17,7 +17,7 @@ struct TypedIdentifier<T>: TypedIdentifierProtocol {
     }
 }
 
-protocol TypedIdentifierProtocol: RawRepresentable, Codable, Equatable, Hashable, CustomStringConvertible, Comparable, Sendable {
+protocol TypedIdentifierProtocol: RawRepresentable, Codable, Equatable, Hashable, CustomStringConvertible, CustomDebugStringConvertible, Comparable, Sendable {
     var rawValue: String { get }
     init(rawValue: String)
 }
@@ -34,6 +34,7 @@ extension TypedIdentifierProtocol {
     }
 
     var description: String { rawValue }
+    var debugDescription: String { "\(Self.self)(\(rawValue))" }
 }
 
 extension TypedIdentifierProtocol {