hexconv 0.2.5__tar.gz → 0.2.7__tar.gz

{hexconv-0.2.5/src/hexconv.egg-info → hexconv-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexconv
-Version: 0.2.5
+Version: 0.2.7
 Summary: Pythonic conversion toolkit for bytes, hex, integers, arrays, binary strings, base64, and text.
 Author: hexconv contributors
 License-Expression: MIT
@@ -59,6 +59,25 @@ hx.from_text("data").hex
 # '64617461'
 ```
 
+The bare `.hex`, `.text`, and `.bytes` properties are shortcuts for zero-argument
+`to_*` methods. Call the method form when you need options:
+
+```python
+value = hx.from_hex("deadbeef")
+
+value.to_hex()
+# 'deadbeef'  (same as value.hex)
+
+value.to_hex(sep=" ", uppercase=True)
+# 'DE AD BE EF'
+
+value.to_bytes()
+# b'\xde\xad\xbe\xef'
+
+hx.from_hex("68656c6c6f").to_text()
+# 'hello'
+```
+
 ## Fast compose
 
 Create your own converters by snapping together
@@ -186,12 +205,6 @@ conv("12345678")
 More conversion patterns:
 
 ```python
-hx.Text()("hello").bytes
-# b'hello'
-
-hx.Hex()("68656c6c6f").text
-# 'hello'
-
 hx.BytesArray()([0x4F, 0x4B]).to(hx.Text())
 # 'OK'
 

{hexconv-0.2.5 → hexconv-0.2.7}/README.md

@@ -30,6 +30,25 @@ hx.from_text("data").hex
 # '64617461'
 ```
 
+The bare `.hex`, `.text`, and `.bytes` properties are shortcuts for zero-argument
+`to_*` methods. Call the method form when you need options:
+
+```python
+value = hx.from_hex("deadbeef")
+
+value.to_hex()
+# 'deadbeef'  (same as value.hex)
+
+value.to_hex(sep=" ", uppercase=True)
+# 'DE AD BE EF'
+
+value.to_bytes()
+# b'\xde\xad\xbe\xef'
+
+hx.from_hex("68656c6c6f").to_text()
+# 'hello'
+```
+
 ## Fast compose
 
 Create your own converters by snapping together
@@ -157,12 +176,6 @@ conv("12345678")
 More conversion patterns:
 
 ```python
-hx.Text()("hello").bytes
-# b'hello'
-
-hx.Hex()("68656c6c6f").text
-# 'hello'
-
 hx.BytesArray()([0x4F, 0x4B]).to(hx.Text())
 # 'OK'
 

{hexconv-0.2.5 → hexconv-0.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hexconv"
-version = "0.2.5"
+version = "0.2.7"
 description = "Pythonic conversion toolkit for bytes, hex, integers, arrays, binary strings, base64, and text."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"

{hexconv-0.2.5 → hexconv-0.2.7}/src/hexconv/_core.py

@@ -462,7 +462,7 @@ _BINARY_CHARS = re.compile(r"^[01]*$")
 
 @dataclass(frozen=True)
 class Value:
-    """Canonical byte-backed value with output methods for common formats."""
+    """Byte-backed value with output methods for common formats."""
 
     _data: bytes
     source: str | None = None
@@ -987,7 +987,7 @@ class Converter:
         return parsed.to(self.to, **self.output_options)
 
     def parse(self, value: Any) -> Value:
-        """Parse a value and return the canonical Value instead of emitting."""
+        """Parse a value and return the parsed Value instead of emitting."""
 
         return _parse(value, self.from_, **self.input_options)
 

{hexconv-0.2.5 → hexconv-0.2.7/src/hexconv.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexconv
-Version: 0.2.5
+Version: 0.2.7
 Summary: Pythonic conversion toolkit for bytes, hex, integers, arrays, binary strings, base64, and text.
 Author: hexconv contributors
 License-Expression: MIT
@@ -59,6 +59,25 @@ hx.from_text("data").hex
 # '64617461'
 ```
 
+The bare `.hex`, `.text`, and `.bytes` properties are shortcuts for zero-argument
+`to_*` methods. Call the method form when you need options:
+
+```python
+value = hx.from_hex("deadbeef")
+
+value.to_hex()
+# 'deadbeef'  (same as value.hex)
+
+value.to_hex(sep=" ", uppercase=True)
+# 'DE AD BE EF'
+
+value.to_bytes()
+# b'\xde\xad\xbe\xef'
+
+hx.from_hex("68656c6c6f").to_text()
+# 'hello'
+```
+
 ## Fast compose
 
 Create your own converters by snapping together
@@ -186,12 +205,6 @@ conv("12345678")
 More conversion patterns:
 
 ```python
-hx.Text()("hello").bytes
-# b'hello'
-
-hx.Hex()("68656c6c6f").text
-# 'hello'
-
 hx.BytesArray()([0x4F, 0x4B]).to(hx.Text())
 # 'OK'