feat: add bool/boolean type alias

Add bool and boolean as type aliases mapping to MySQL tinyint.
Update tests and documentation accordingly.

Author: claude

docs/src/design/tables/attributes.md

@@ -85,6 +85,7 @@ libraries, making table definitions more readable and explicit about data precis
 
 | Alias | MySQL Type | Description |
 |-------|------------|-------------|
+| `bool` / `boolean` | `tinyint` | Boolean value (0 or 1) |
 | `int8` | `tinyint` | 8-bit signed integer (-128 to 127) |
 | `uint8` | `tinyint unsigned` | 8-bit unsigned integer (0 to 255) |
 | `int16` | `smallint` | 16-bit signed integer (-32,768 to 32,767) |
@@ -108,6 +109,7 @@ class Measurement(dj.Manual):
     precise_value : float64     # double-precision measurement
     sample_count : uint32       # unsigned 32-bit counter
     sensor_flags : uint8        # 8-bit status flags
+    is_valid : bool             # boolean flag
     """
 ```
 

src/datajoint/declare.py

@@ -28,6 +28,7 @@
     "UINT16": "smallint unsigned",
     "INT8": "tinyint",
     "UINT8": "tinyint unsigned",
+    "BOOL": "tinyint",
 }
 MAX_TABLE_NAME_LENGTH = 64
 CONSTANT_LITERALS = {
@@ -50,14 +51,14 @@
         UINT16=r"uint16$",
         INT8=r"int8$",
         UINT8=r"uint8$",
+        BOOL=r"bool(ean)?$",  # aliased to tinyint
         # Native MySQL types
         INTEGER=r"((tiny|small|medium|big|)int|integer)(\s*\(.+\))?(\s+unsigned)?(\s+auto_increment)?|serial$",
         DECIMAL=r"(decimal|numeric)(\s*\(.+\))?(\s+unsigned)?$",
         FLOAT=r"(double|float|real)(\s*\(.+\))?(\s+unsigned)?$",
         STRING=r"(var)?char\s*\(.+\)$",
         JSON=r"json$",
         ENUM=r"enum\s*\(.+\)$",
-        BOOL=r"bool(ean)?$",  # aliased to tinyint(1)
         TEMPORAL=r"(date|datetime|time|timestamp|year)(\s*\(.+\))?$",
         INTERNAL_BLOB=r"(tiny|small|medium|long|)blob$",
         EXTERNAL_BLOB=r"blob@(?P<store>[a-z][\-\w]*)$",

tests/schema_type_aliases.py

@@ -22,6 +22,7 @@ class TypeAliasTable(dj.Manual):
     val_uint16 : uint16       # 16-bit unsigned integer
     val_int8 : int8           # 8-bit signed integer
     val_uint8 : uint8         # 8-bit unsigned integer
+    val_bool : bool           # boolean value
     """
 
 

tests/test_type_aliases.py

@@ -25,6 +25,8 @@ class TestTypeAliasPatterns:
             ("uint16", "UINT16"),
             ("int8", "INT8"),
             ("uint8", "UINT8"),
+            ("bool", "BOOL"),
+            ("boolean", "BOOL"),
         ],
     )
     def test_type_alias_pattern_matching(self, alias, expected_category):
@@ -47,6 +49,8 @@ def test_type_alias_pattern_matching(self, alias, expected_category):
             ("uint16", "smallint unsigned"),
             ("int8", "tinyint"),
             ("uint8", "tinyint unsigned"),
+            ("bool", "tinyint"),
+            ("boolean", "tinyint"),
         ],
     )
     def test_type_alias_mysql_mapping(self, alias, expected_mysql_type):
@@ -107,6 +111,7 @@ def test_heading_preserves_type_aliases(self, schema_type_aliases):
         assert "uint16" in heading_str
         assert "int8" in heading_str
         assert "uint8" in heading_str
+        assert "bool" in heading_str
 
 
 class TestTypeAliasInsertFetch:
@@ -129,6 +134,7 @@ def test_insert_and_fetch(self, schema_type_aliases):
             val_uint16=65535,  # max uint16
             val_int8=127,  # max int8
             val_uint8=255,  # max uint8
+            val_bool=1,  # boolean true
         )
 
         table.insert1(test_data)
@@ -145,6 +151,7 @@ def test_insert_and_fetch(self, schema_type_aliases):
         assert fetched["val_uint16"] == test_data["val_uint16"]
         assert fetched["val_int8"] == test_data["val_int8"]
         assert fetched["val_uint8"] == test_data["val_uint8"]
+        assert fetched["val_bool"] == test_data["val_bool"]
 
     def test_insert_primary_key_with_aliases(self, schema_type_aliases):
         """Test using type aliases in primary key."""