Add mbtiles statistics command (#986)

- [x] Add tile statistics to mbtiles tools
- [x] Add test
- [x] Use 4326 instead of 3857 for tile bounds
- [x] Add document
- [x] Use size-format to prettify output 
- [x]  Statistics  struct Refactor
- [x] Cleanup and reformat

Closes #964 

---------

Co-authored-by: Yuri Astrakhan <[email protected]>

Cargo.toml

@@ -16,6 +16,7 @@ actix-http = "3"
 actix-rt = "2"
 actix-web = "4"
 anyhow = "1.0"
+approx = "0.5.1"
 async-trait = "0.1"
 bit-set = "0.5.3"
 brotli = "3"
@@ -52,6 +53,7 @@ serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 serde_with = "3"
 serde_yaml = "0.9"
+size_format = "1.0.2"
 spreet = { version = "0.9", default-features = false }
 sqlite-hashes = { version = "0.5", default-features = false, features = ["md5", "window", "hex"] }
 sqlx = { version = "0.7", features = ["sqlite", "runtime-tokio"] }

docs/src/55-mbtiles-stats.md

@@ -0,0 +1,19 @@
+# Get a tile statistics from MBTiles file
+
+For the concern of efficiency, you could figure out the page size and file size, tile size and  bounds(represented as WGS 84 latitude and longitude values) of covered area with `mbtiles stats` command.
+
+```shell
+File: /path/to/world_cities.mbtiles
+FileSize: 48.00KiB
+Schema: flat
+Page size: 4.00KiB
+|  Zoom   |  Count  |Smallest | Largest | Average |  BBox   |
+|        0|        1|  1.08KiB|  1.08KiB|  1.08KiB|-179.99999997494382,-85.05112877764508,180.00000015460688,85.05112879314403|
+|        1|        4|     160B|     650B|     366B|-179.99999997494382,-85.05112877764508,180.00000015460688,85.05112879314403|
+|        2|        7|     137B|     495B|     239B|-179.99999997494382,-66.51326042021836,180.00000015460688,66.51326049182072|
+|        3|       17|      67B|     246B|     134B|-134.99999995874995,-40.9798980140281,180.00000015460688,66.51326049182072|
+|        4|       38|      64B|     175B|      86B|-134.99999995874995,-40.9798980140281,180.00000015460688,66.51326049182072|
+|        5|       57|      64B|     107B|      72B|-123.74999995470151,-40.9798980140281,180.00000015460688,61.60639642757953|
+|        6|       72|      64B|      97B|      68B|-123.74999995470151,-40.9798980140281,180.00000015460688,61.60639642757953|
+|      all|      196|      64B|   1.0KiB|      96B|
+```

docs/src/SUMMARY.md

@@ -26,4 +26,5 @@
   - [MBTiles Copying / Diffing](52-mbtiles-copy.md)
   - [MBTiles Validation](53-mbtiles-validation.md)
   - [MBTiles Schemas](54-mbtiles-schema.md)
+  - [MBTiles statistics](55-mbtiles-stats.md)
 - [Development](60-development.md)

mbtiles/Cargo.toml

@@ -19,9 +19,10 @@ enum-display.workspace = true
 futures.workspace = true
 log.workspace = true
 martin-tile-utils.workspace = true
-serde.workspace = true
 serde_json.workspace = true
+serde.workspace = true
 serde_with.workspace = true
+size_format.workspace = true
 sqlite-hashes.workspace = true
 sqlx.workspace = true
 thiserror.workspace = true
@@ -37,9 +38,10 @@ tokio = { workspace = true, features = ["rt-multi-thread"], optional = true }
 [dev-dependencies]
 # For testing, might as well use the same async framework as the Martin itself
 actix-rt.workspace = true
+approx.workspace = true
 ctor.workspace = true
 env_logger.workspace = true
-insta = { workspace = true, features = ["toml"] }
+insta = { workspace = true, features = ["toml", "yaml"] }
 pretty_assertions.workspace = true
 rstest.workspace = true
 

mbtiles/src/bin/main.rs

@@ -26,6 +26,9 @@ enum Commands {
         /// MBTiles file to read from
         file: PathBuf,
     },
+    /// Gets tile statistics from MBTiels file
+    #[command(name = "stats")]
+    Stats { file: PathBuf },
     /// Gets a single value from the MBTiles metadata table.
     #[command(name = "meta-get")]
     MetaGetValue {
@@ -114,6 +117,13 @@ async fn main_int() -> anyhow::Result<()> {
             let mbt = Mbtiles::new(file.as_path())?;
             mbt.validate(integrity_check, update_agg_tiles_hash).await?;
         }
+        Commands::Stats { file } => {
+            let mbt = Mbtiles::new(file.as_path())?;
+            let mut conn = mbt.open_readonly().await?;
+
+            let statistics = mbt.statistics(&mut conn).await?;
+            println!("{statistics}");
+        }
     }
 
     Ok(())