feat(catalog): initial support for describe

src/config.rs

@@ -29,6 +29,12 @@ pub enum CatalogSubcommand {
         #[clap(long = "only", value_enum, value_parser)]
         sublist: Option<SubList>,
     },
+    /// Describe the content of a backup file.
+    Describe {
+        /// Path to the backup file.
+        #[clap(value_parser, value_hint = ValueHint::FilePath)]
+        backup_filepath: PathBuf,
+    },
     /// Delete outdated backups by applying the catalog's compaction strategy.
     Compact,
 }

src/main.rs

@@ -31,6 +31,7 @@ async fn run(config: Config) {
     match config.command {
         Command::Catalog { command } => match command {
             CatalogSubcommand::List { sublist } => catalog.list(sublist),
+            CatalogSubcommand::Describe { backup_filepath } => catalog.describe(backup_filepath),
             CatalogSubcommand::Compact => match catalog.compact().await {
                 Ok(n) => {
                     let message = format!("✅ deleted {n} outdated backups");

src/management/catalog.rs

@@ -186,6 +186,16 @@ impl Catalog {
             );
         }
     }
+
+    pub fn describe<P>(&self, backup_filepath: P)
+    where
+        P: AsRef<Path>,
+    {
+        println!(
+            "describing `{}`",
+            backup_filepath.as_ref().to_string_lossy()
+        );
+    }
 }
 
 // Private functions