Add methods to create instances from data of any floating-point types

Author: arithy

python/src/softfloatpy/_core.pyi

@@ -48,6 +48,7 @@ def test_bf16_to_f32() -> None:
     o: sf.BFloat16 = sf.BFloat16.from_float(f)
     assert sf.bf16_to_f32(o).to_float() == f
     assert sf.bf16_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.BFloat16.from_f32(o.to_f32()).to_bytes() == o.to_bytes()
 
 
 def test_bf16_is_signaling_nan() -> None:

python/src/softfloatpy/_core.pyx

@@ -49,48 +49,61 @@ def test_f128_to_ui32() -> None:
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_ui32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f128_to_ui32(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float128.from_ui32(o.to_ui32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f128_to_ui64() -> None:
     f: float = 12.3
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_ui64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f128_to_ui64(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float128.from_ui64(o.to_ui64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f128_to_i32() -> None:
     f: float = -12.3
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_i32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f128_to_i32(o, sf.RoundingMode.MIN).to_bytes() == o.to_i32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float128.from_i32(o.to_i32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f128_to_i64() -> None:
     f: float = -12.3
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_i64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f128_to_i64(o, sf.RoundingMode.MIN).to_bytes() == o.to_i64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float128.from_i64(o.to_i64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f128_to_f16() -> None:
     f: float = -12.5
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_f16(o).to_float() == f
     assert sf.f128_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.Float128.from_f16(o.to_f16()).to_bytes() == o.to_bytes()
 
 
 def test_f128_to_f32() -> None:
     f: float = -12.5
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_f32(o).to_float() == f
     assert sf.f128_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.Float128.from_f32(o.to_f32()).to_bytes() == o.to_bytes()
 
 
 def test_f128_to_f64() -> None:
     f: float = -12.5
     o: sf.Float128 = sf.Float128.from_float(f)
     assert sf.f128_to_f64(o).to_float() == f
     assert sf.f128_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.Float128.from_f64(o.to_f64()).to_bytes() == o.to_bytes()
+
+
+def test_f128_to_f128() -> None:
+    f: float = -12.5
+    o: sf.Float128 = sf.Float128.from_float(f)
+    assert sf.Float128.from_f128(o.to_f128()).to_bytes() == o.to_bytes()
 
 
 def test_f128_round_to_int() -> None:

python/tests/softfloatpy/test_bfloat16.py

@@ -49,48 +49,61 @@ def test_f16_to_ui32() -> None:
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_ui32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f16_to_ui32(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float16.from_ui32(o.to_ui32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f16_to_ui64() -> None:
     f: float = 12.3
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_ui64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f16_to_ui64(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float16.from_ui64(o.to_ui64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f16_to_i32() -> None:
     f: float = -12.3
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_i32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f16_to_i32(o, sf.RoundingMode.MIN).to_bytes() == o.to_i32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float16.from_i32(o.to_i32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f16_to_i64() -> None:
     f: float = -12.3
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_i64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f16_to_i64(o, sf.RoundingMode.MIN).to_bytes() == o.to_i64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float16.from_i64(o.to_i64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
+
+
+def test_f16_to_f16() -> None:
+    f: float = -12.5
+    o: sf.Float16 = sf.Float16.from_float(f)
+    assert sf.Float16.from_f16(o.to_f16()).to_bytes() == o.to_bytes()
 
 
 def test_f16_to_f32() -> None:
     f: float = -12.5
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_f32(o).to_float() == f
     assert sf.f16_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.Float16.from_f32(o.to_f32()).to_bytes() == o.to_bytes()
 
 
 def test_f16_to_f64() -> None:
     f: float = -12.5
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_f64(o).to_float() == f
     assert sf.f16_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.Float16.from_f64(o.to_f64()).to_bytes() == o.to_bytes()
 
 
 def test_f16_to_f128() -> None:
     f: float = -12.5
     o: sf.Float16 = sf.Float16.from_float(f)
     assert sf.f16_to_f128(o).to_float() == f
     assert sf.f16_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.Float16.from_f128(o.to_f128()).to_bytes() == o.to_bytes()
 
 
 def test_f16_round_to_int() -> None:

python/tests/softfloatpy/test_float128.py

@@ -48,55 +48,70 @@ def test_f32_to_bf16() -> None:
     f: float = -12.5
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_bf16(o).to_float() == f
+    assert sf.f32_to_bf16(o).to_bytes() == o.to_bf16().to_bytes()
+    assert sf.Float32.from_bf16(o.to_bf16()).to_bytes() == o.to_bytes()
 
 
 def test_f32_to_ui32() -> None:
     f: float = 12.3
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_ui32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f32_to_ui32(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float32.from_ui32(o.to_ui32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f32_to_ui64() -> None:
     f: float = 12.3
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_ui64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f32_to_ui64(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float32.from_ui64(o.to_ui64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f32_to_i32() -> None:
     f: float = -12.3
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_i32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f32_to_i32(o, sf.RoundingMode.MIN).to_bytes() == o.to_i32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float32.from_i32(o.to_i32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f32_to_i64() -> None:
     f: float = -12.3
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_i64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f32_to_i64(o, sf.RoundingMode.MIN).to_bytes() == o.to_i64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float32.from_i64(o.to_i64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f32_to_f16() -> None:
     f: float = -12.5
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_f16(o).to_float() == f
     assert sf.f32_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.Float32.from_f16(o.to_f16()).to_bytes() == o.to_bytes()
+
+
+def test_f32_to_f32() -> None:
+    f: float = -12.5
+    o: sf.Float32 = sf.Float32.from_float(f)
+    assert sf.Float32.from_f32(o.to_f32()).to_bytes() == o.to_bytes()
 
 
 def test_f32_to_f64() -> None:
     f: float = -12.5
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_f64(o).to_float() == f
     assert sf.f32_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.Float32.from_f64(o.to_f64()).to_bytes() == o.to_bytes()
 
 
 def test_f32_to_f128() -> None:
     f: float = -12.5
     o: sf.Float32 = sf.Float32.from_float(f)
     assert sf.f32_to_f128(o).to_float() == f
     assert sf.f32_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.Float32.from_f128(o.to_f128()).to_bytes() == o.to_bytes()
 
 
 def test_f32_round_to_int() -> None:

python/tests/softfloatpy/test_float16.py

@@ -49,48 +49,61 @@ def test_f64_to_ui32() -> None:
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_ui32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f64_to_ui32(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float64.from_ui32(o.to_ui32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f64_to_ui64() -> None:
     f: float = 12.3
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_ui64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f64_to_ui64(o, sf.RoundingMode.MIN).to_bytes() == o.to_ui64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float64.from_ui64(o.to_ui64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f64_to_i32() -> None:
     f: float = -12.3
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_i32(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f64_to_i32(o, sf.RoundingMode.MIN).to_bytes() == o.to_i32(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float64.from_i32(o.to_i32(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f64_to_i64() -> None:
     f: float = -12.3
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_i64(o, sf.RoundingMode.MIN).to_int() == math.floor(f)
     assert sf.f64_to_i64(o, sf.RoundingMode.MIN).to_bytes() == o.to_i64(sf.RoundingMode.MIN).to_bytes()
+    assert sf.Float64.from_i64(o.to_i64(sf.RoundingMode.MIN)).to_bytes() == o.round_to_int(sf.RoundingMode.MIN).to_bytes()
 
 
 def test_f64_to_f16() -> None:
     f: float = -12.5
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_f16(o).to_float() == f
     assert sf.f64_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.Float64.from_f16(o.to_f16()).to_bytes() == o.to_bytes()
 
 
 def test_f64_to_f32() -> None:
     f: float = -12.5
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_f32(o).to_float() == f
     assert sf.f64_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.Float64.from_f32(o.to_f32()).to_bytes() == o.to_bytes()
+
+
+def test_f64_to_f64() -> None:
+    f: float = -12.5
+    o: sf.Float64 = sf.Float64.from_float(f)
+    assert sf.Float64.from_f64(o.to_f64()).to_bytes() == o.to_bytes()
 
 
 def test_f64_to_f128() -> None:
     f: float = -12.5
     o: sf.Float64 = sf.Float64.from_float(f)
     assert sf.f64_to_f128(o).to_float() == f
     assert sf.f64_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.Float64.from_f128(o.to_f128()).to_bytes() == o.to_bytes()
 
 
 def test_f64_round_to_int() -> None:

python/tests/softfloatpy/test_float32.py

@@ -1,6 +1,6 @@
 # SoftFloatPy: A Python binding of Berkeley SoftFloat.
 #
-# Copyright (c) 2024-2025 Arihiro Yoshida. All rights reserved.
+# Copyright (c) 2024-2026 Arihiro Yoshida. All rights reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -44,27 +44,31 @@ def test_i32_to_f16() -> None:
     o: sf.Int32 = sf.Int32.from_int(i)
     assert sf.i32_to_f16(o).to_float() == float(i)
     assert sf.i32_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.Int32.from_f16(o.to_f16(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i32_to_f32() -> None:
     i: int = -123
     o: sf.Int32 = sf.Int32.from_int(i)
     assert sf.i32_to_f32(o).to_float() == float(i)
     assert sf.i32_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.Int32.from_f32(o.to_f32(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i32_to_f64() -> None:
     i: int = -123
     o: sf.Int32 = sf.Int32.from_int(i)
     assert sf.i32_to_f64(o).to_float() == float(i)
     assert sf.i32_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.Int32.from_f64(o.to_f64(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i32_to_f128() -> None:
     i: int = -123
     o: sf.Int32 = sf.Int32.from_int(i)
     assert sf.i32_to_f128(o).to_float() == float(i)
     assert sf.i32_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.Int32.from_f128(o.to_f128(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_operators() -> None:

python/tests/softfloatpy/test_float64.py

@@ -1,6 +1,6 @@
 # SoftFloatPy: A Python binding of Berkeley SoftFloat.
 #
-# Copyright (c) 2024-2025 Arihiro Yoshida. All rights reserved.
+# Copyright (c) 2024-2026 Arihiro Yoshida. All rights reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -44,27 +44,31 @@ def test_i64_to_f16() -> None:
     o: sf.Int64 = sf.Int64.from_int(i)
     assert sf.i64_to_f16(o).to_float() == float(i)
     assert sf.i64_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.Int64.from_f16(o.to_f16(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i64_to_f32() -> None:
     i: int = -123
     o: sf.Int64 = sf.Int64.from_int(i)
     assert sf.i64_to_f32(o).to_float() == float(i)
     assert sf.i64_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.Int64.from_f32(o.to_f32(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i64_to_f64() -> None:
     i: int = -123
     o: sf.Int64 = sf.Int64.from_int(i)
     assert sf.i64_to_f64(o).to_float() == float(i)
     assert sf.i64_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.Int64.from_f64(o.to_f64(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_i64_to_f128() -> None:
     i: int = -123
     o: sf.Int64 = sf.Int64.from_int(i)
     assert sf.i64_to_f128(o).to_float() == float(i)
     assert sf.i64_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.Int64.from_f128(o.to_f128(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_operators() -> None:

python/tests/softfloatpy/test_int32.py

@@ -1,6 +1,6 @@
 # SoftFloatPy: A Python binding of Berkeley SoftFloat.
 #
-# Copyright (c) 2024-2025 Arihiro Yoshida. All rights reserved.
+# Copyright (c) 2024-2026 Arihiro Yoshida. All rights reserved.
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -44,27 +44,31 @@ def test_ui32_to_f16() -> None:
     o: sf.UInt32 = sf.UInt32.from_int(i)
     assert sf.ui32_to_f16(o).to_float() == float(i)
     assert sf.ui32_to_f16(o).to_bytes() == o.to_f16().to_bytes()
+    assert sf.UInt32.from_f16(o.to_f16(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_ui32_to_f32() -> None:
     i: int = 123
     o: sf.UInt32 = sf.UInt32.from_int(i)
     assert sf.ui32_to_f32(o).to_float() == float(i)
     assert sf.ui32_to_f32(o).to_bytes() == o.to_f32().to_bytes()
+    assert sf.UInt32.from_f32(o.to_f32(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_ui32_to_f64() -> None:
     i: int = 123
     o: sf.UInt32 = sf.UInt32.from_int(i)
     assert sf.ui32_to_f64(o).to_float() == float(i)
     assert sf.ui32_to_f64(o).to_bytes() == o.to_f64().to_bytes()
+    assert sf.UInt32.from_f64(o.to_f64(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_ui32_to_f128() -> None:
     i: int = 123
     o: sf.UInt32 = sf.UInt32.from_int(i)
     assert sf.ui32_to_f128(o).to_float() == float(i)
     assert sf.ui32_to_f128(o).to_bytes() == o.to_f128().to_bytes()
+    assert sf.UInt32.from_f128(o.to_f128(), sf.RoundingMode.MIN).to_bytes() == o.to_bytes()
 
 
 def test_operators() -> None: