feat: implemented helpers for one-way object to string conversion

src/StringableInterface.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PetrKnap\Binary;
+
+use Stringable;
+use Throwable;
+
+interface StringableInterface extends Stringable
+{
+    /**
+     * @return string binary representation of this instance
+     *
+     * @throws Throwable
+     */
+    public function toBinary(): string;
+
+    /**
+     * @see self::toBinary()
+     */
+    public function __toString(): string;
+}

src/StringableTrait.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PetrKnap\Binary;
+
+trait StringableTrait
+{
+    public function __toString(): string
+    {
+        /** @var StringableInterface $this */
+        return $this->toBinary();
+    }
+}

tests/StringableTest.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PetrKnap\Binary;
+
+use PHPUnit\Framework\TestCase;
+
+final class StringableTest extends TestCase
+{
+    public const DATA = b'data';
+
+    public function testToBinaryMethodWorks(): void
+    {
+        self::assertSame(
+            self::DATA,
+            self::getStringableInstance()->toBinary(),
+        );
+    }
+
+    public function testNativeConversionWorks(): void
+    {
+        self::assertSame(
+            self::DATA,
+            (string) self::getStringableInstance(),
+        );
+    }
+
+    private function getStringableInstance(): StringableInterface
+    {
+        return new class () implements StringableInterface {
+            use StringableTrait;
+
+            public function toBinary(): string
+            {
+                return StringableTest::DATA;
+            }
+        };
+    }
+}