Add BitBoard::to_matrix_and_offset Python method

Author: nnmm

gomori/README.md

@@ -2,4 +2,8 @@
 
 Game logic and tools for writing gomori bots. There is also a crate that implements the main loop for you: [gomori_bot_utils](../gomori_bot_utils).
 
-See `cargo doc --open` for documentation. There is also an [online version](https://nnmm.github.io/docs/gomori) (+ for [gomori_bot_utils](https://nnmm.github.io/docs/gomori_bot_utils)), but it is not automatically updated, so might get outdated.
+See `cargo doc --open` for documentation. There is also an [online version](https://nnmm.github.io/docs/gomori) (+ for [gomori_bot_utils](https://nnmm.github.io/docs/gomori_bot_utils)), but it is not automatically updated, so might get outdated.
+
+## Debugging
+
+This crate includes a handful of `debug_assert!` calls, so if something is not working right, it is worth compiling in debug mode.

gomori/src/board/bitboard.rs

@@ -457,6 +457,17 @@ mod python {
         fn __bool__(&self) -> bool {
             !self.is_empty()
         }
+
+        // Python exclusive
+        fn to_matrix_and_offset(&self) -> ([[bool; 7]; 7], (i8, i8)) {
+            let arr = std::array::from_fn(|i_local| {
+                std::array::from_fn(|j_local| {
+                    let idx = i_local * 7 + j_local;
+                    self.bits & (1u64 << idx) != 0
+                })
+            });
+            (arr, self.offset())
+        }
     }
 }