feat(python): add bfloat16 and bfloat16_array support

BUILD

@@ -23,6 +23,7 @@ pyx_library(
     name = "buffer",
     srcs = glob([
         "python/pyfory/includes/*.pxd",
+        "python/pyfory/bfloat16.pxd",
         "python/pyfory/buffer.pxd",
         "python/pyfory/buffer.pyx",
         "python/pyfory/__init__.py",
@@ -54,6 +55,7 @@ pyx_library(
     name = "serialization",
     srcs = glob([
         "python/pyfory/includes/*.pxd",
+        "python/pyfory/bfloat16.pxd",
         "python/pyfory/buffer.pxd",
         "python/pyfory/serialization.pyx",
         "python/pyfory/*.pxi",
@@ -70,12 +72,25 @@ pyx_library(
     ],
 )
 
+pyx_library(
+    name = "bfloat16",
+    srcs = glob([
+        "python/pyfory/bfloat16.pxd",
+        "python/pyfory/bfloat16.pyx",
+        "python/pyfory/__init__.py",
+    ]),
+    cc_kwargs = dict(
+        linkstatic = 1,
+    ),
+)
+
 pyx_library(
     name = "_format",
     srcs = glob(
         [
             "python/pyfory/__init__.py",
             "python/pyfory/includes/*.pxd",
+            "python/pyfory/bfloat16.pxd",
             "python/pyfory/buffer.pxd",
             "python/pyfory/*.pxi",
             "python/pyfory/format/_format.pyx",
@@ -96,6 +111,7 @@ genrule(
     name = "cp_fory_so",
     srcs = [
         ":python/pyfory/buffer.so",
+        ":python/pyfory/bfloat16.so",
         ":python/pyfory/lib/mmh3/mmh3.so",
         ":python/pyfory/format/_format.so",
         ":python/pyfory/serialization.so",
@@ -111,11 +127,13 @@ genrule(
         if [ "$${u_name: 0: 4}" == "MING" ] || [ "$${u_name: 0: 4}" == "MSYS" ]
         then
             cp -f $(location python/pyfory/buffer.so) "$$WORK_DIR/python/pyfory/buffer.pyd"
+            cp -f $(location python/pyfory/bfloat16.so) "$$WORK_DIR/python/pyfory/bfloat16.pyd"
             cp -f $(location python/pyfory/lib/mmh3/mmh3.so) "$$WORK_DIR/python/pyfory/lib/mmh3/mmh3.pyd"
             cp -f $(location python/pyfory/format/_format.so) "$$WORK_DIR/python/pyfory/format/_format.pyd"
             cp -f $(location python/pyfory/serialization.so) "$$WORK_DIR/python/pyfory/serialization.pyd"
         else
             cp -f $(location python/pyfory/buffer.so) "$$WORK_DIR/python/pyfory"
+            cp -f $(location python/pyfory/bfloat16.so) "$$WORK_DIR/python/pyfory"
             cp -f $(location python/pyfory/lib/mmh3/mmh3.so) "$$WORK_DIR/python/pyfory/lib/mmh3"
             cp -f $(location python/pyfory/format/_format.so) "$$WORK_DIR/python/pyfory/format"
             cp -f $(location python/pyfory/serialization.so) "$$WORK_DIR/python/pyfory"

python/README.md

@@ -490,6 +490,34 @@ fory.register(Person.class, "example.Person");
 Person person = (Person) fory.deserialize(binaryData);
 ```
 
+### BFloat16 Support
+
+`pyfory` supports `bfloat16` scalar values and `bfloat16` arrays in xlang mode:
+
+- Scalar type: `pyfory.BFloat16` (type id `18`)
+- Array type: `pyfory.BFloat16Array` (type id `54`)
+
+```python
+import pyfory
+from pyfory import BFloat16, BFloat16Array
+
+fory = pyfory.Fory(xlang=True, ref=False, strict=True)
+
+# Scalar bfloat16
+v = BFloat16(3.1415926)
+data = fory.serialize(v)
+out = fory.deserialize(data)
+print(float(out))
+
+# bfloat16 array
+arr = BFloat16Array([1.0, 2.5, -3.25])
+data = fory.serialize(arr)
+out = fory.deserialize(data)
+print(out)
+```
+
+`BFloat16Array` stores values in a packed `array('H')` representation and writes bytes in little-endian order for cross-language compatibility.
+
 ## 📊 Row Format - Zero-Copy Processing
 
 Apache Fury™ provides a random-access row format that enables reading nested fields from binary data without full deserialization. This drastically reduces overhead when working with large objects where only partial data access is needed. The format also supports memory-mapped files for ultra-low memory footprint.

python/pyfory/__init__.py

@@ -50,6 +50,7 @@
     TaggedUint64Serializer,
     Float32Serializer,
     Float64Serializer,
+    BFloat16Serializer,
     StringSerializer,
     DateSerializer,
     TimestampSerializer,
@@ -88,6 +89,8 @@
     tagged_uint64,
     float32,
     float64,
+    bfloat16 as bfloat16_type,
+    bfloat16_array,
     int8_array,
     uint8_array,
     int16_array,
@@ -118,6 +121,13 @@
 from pyfory.policy import DeserializationPolicy  # noqa: F401 # pylint: disable=unused-import
 from pyfory.buffer import Buffer  # noqa: F401 # pylint: disable=unused-import
 
+# BFloat16 support
+from pyfory.bfloat16 import bfloat16  # noqa: F401
+from pyfory.bfloat16_array import BFloat16Array  # noqa: F401
+
+# Keep compatibility with existing API naming.
+BFloat16 = bfloat16
+
 __version__ = "0.16.0.dev0"
 
 __all__ = [
@@ -151,6 +161,10 @@
     "tagged_uint64",
     "float32",
     "float64",
+    "BFloat16",
+    "BFloat16Array",
+    "bfloat16",
+    "bfloat16_array",
     "int8_array",
     "uint8_array",
     "int16_array",
@@ -192,6 +206,7 @@
     "TaggedUint64Serializer",
     "Float32Serializer",
     "Float64Serializer",
+    "BFloat16Serializer",
     "StringSerializer",
     "DateSerializer",
     "TimestampSerializer",