Better layout docs and source

CHANGELOG.md

@@ -4,6 +4,8 @@
 
 * Fix Ctrl combination handling for Colemak and De105Key layouts
 * Fix 102/105-key German layout: Add missing Alt-Gr combinations
+* Added tool to print keyboard layouts as ASCII-art
+* Cleaned up how layouts are implemented
 
 ## v0.8.0 (13 Sep 2024)
 

Cargo.toml

@@ -8,5 +8,6 @@ categories = ["embedded", "no-std"]
 license = "MIT OR Apache-2.0"
 repository = "https://github.com/rust-embedded-community/pc-keyboard.git"
 edition = "2021"
+rust-version = "1.61"
 
 [dependencies]

src/layouts/mod.rs

@@ -5,6 +5,8 @@
 //! see [`Uk105Key`] and [`Us104Key`] as an example of that.
 
 mod dvorak_programmer104;
+use crate::PhysicalKeyboard;
+
 pub use self::dvorak_programmer104::DVP104Key;
 
 mod dvorak104;
@@ -68,6 +70,21 @@ impl super::KeyboardLayout for AnyLayout {
             AnyLayout::FiSe105Key(inner) => inner.map_keycode(keycode, modifiers, handle_ctrl),
         }
     }
+
+    fn get_physical(&self) -> PhysicalKeyboard {
+        match self {
+            AnyLayout::DVP104Key(inner) => inner.get_physical(),
+            AnyLayout::Dvorak104Key(inner) => inner.get_physical(),
+            AnyLayout::Us104Key(inner) => inner.get_physical(),
+            AnyLayout::Uk105Key(inner) => inner.get_physical(),
+            AnyLayout::Jis109Key(inner) => inner.get_physical(),
+            AnyLayout::Azerty(inner) => inner.get_physical(),
+            AnyLayout::Colemak(inner) => inner.get_physical(),
+            AnyLayout::De105Key(inner) => inner.get_physical(),
+            AnyLayout::No105Key(inner) => inner.get_physical(),
+            AnyLayout::FiSe105Key(inner) => inner.get_physical(),
+        }
+    }
 }
 
 impl super::KeyboardLayout for &AnyLayout {
@@ -90,6 +107,21 @@ impl super::KeyboardLayout for &AnyLayout {
             AnyLayout::FiSe105Key(inner) => inner.map_keycode(keycode, modifiers, handle_ctrl),
         }
     }
+
+    fn get_physical(&self) -> PhysicalKeyboard {
+        match self {
+            AnyLayout::DVP104Key(inner) => inner.get_physical(),
+            AnyLayout::Dvorak104Key(inner) => inner.get_physical(),
+            AnyLayout::Us104Key(inner) => inner.get_physical(),
+            AnyLayout::Uk105Key(inner) => inner.get_physical(),
+            AnyLayout::Jis109Key(inner) => inner.get_physical(),
+            AnyLayout::Azerty(inner) => inner.get_physical(),
+            AnyLayout::Colemak(inner) => inner.get_physical(),
+            AnyLayout::De105Key(inner) => inner.get_physical(),
+            AnyLayout::No105Key(inner) => inner.get_physical(),
+            AnyLayout::FiSe105Key(inner) => inner.get_physical(),
+        }
+    }
 }
 
 #[cfg(test)]