Add some initial debugging capabilities

Author: lu-zero

Cargo.toml

@@ -12,7 +12,13 @@ description = "Formats whitespace in a SQL string to make it easier to read"
 keywords = ["sql"]
 categories = ["development-tools"]
 
+[features]
+debug = ["dep:anstream", "dep:anstyle", "dep:okhsl"]
+
 [dependencies]
+anstream = { version = "0.6.21", optional = true }
+anstyle = { version  = "1.0.13", optional = true }
+okhsl = { version = "1.0.1", optional = true }
 unicode_categories = "0.1.1"
 winnow = { version = "0.7.0", features = ["simd"] }
 

src/debug.rs

@@ -0,0 +1,25 @@
+use std::hash::{DefaultHasher, Hash, Hasher};
+
+use anstyle::RgbColor;
+
+pub(crate) trait ToColor {
+    fn to_color(&self) -> RgbColor;
+}
+
+impl<T: Hash> ToColor for T {
+    fn to_color(&self) -> RgbColor {
+        let mut s = DefaultHasher::new();
+        self.hash(&mut s);
+
+        let v = s.finish();
+
+        let v = ((v >> 32) as u32) ^ (v as u32);
+
+        let h = v as f64 / u32::MAX as f64;
+
+        let c = okhsl::Okhsv { h, s: 0.7, v: 0.9 };
+        let r = c.to_srgb();
+
+        RgbColor(r.r, r.g, r.b)
+    }
+}

src/formatter.rs

@@ -140,6 +140,23 @@ pub(crate) fn format(
                 }
             },
         }
+
+        #[cfg(feature = "debug")]
+        {
+            use crate::debug::*;
+            let b = anstyle::Style::new().bold();
+            let k = b.fg_color(Some(token.kind.to_color().into()));
+            let r = k.render_reset();
+            let k = k.render();
+            let kind = format!("{:?}", token.kind);
+
+            let mut lines = formatted_query
+                .lines()
+                .rev()
+                .filter(|l| !l.trim().is_empty());
+            let line = lines.next().unwrap_or(formatted_query.as_str());
+            anstream::eprintln!("{k}{:21}{r}: {:50} {line}", kind, token.value);
+        }
     }
     formatted_query.trim().to_string()
 }

src/lib.rs

@@ -15,6 +15,9 @@ mod inline_block;
 mod params;
 mod tokenizer;
 
+#[cfg(feature = "debug")]
+mod debug;
+
 /// Formats whitespace in a SQL string to make it easier to read.
 /// Optionally replaces parameter placeholders with `params`.
 pub fn format(query: &str, params: &QueryParams, options: &FormatOptions) -> String {

src/tokenizer.rs

@@ -74,7 +74,7 @@ pub(crate) struct Token<'a> {
     pub alias: &'a str,
 }
 
-#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
 pub(crate) enum TokenKind {
     TypeSpecifier,
     Whitespace,