hexconv 0.1.1__tar.gz → 0.2.0__tar.gz

{hexconv-0.1.1/src/hexconv.egg-info → hexconv-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexconv
-Version: 0.1.1
+Version: 0.2.0
 Summary: Pythonic conversion toolkit for bytes, hex, integers, arrays, binary strings, base64, and text.
 Author: hexconv contributors
 License-Expression: MIT
@@ -60,6 +60,72 @@ hx.from_int_array([0x1234, 0x5678], width=2).to_hex_array(width=2)
 # ['1234', '5678']
 ```
 
+## Configurable formats
+
+For reusable conversions, construct format specs with options:
+
+```python
+hx.convert("de ad be ef", from_=hx.Hex(), to=hx.Bytes())
+# b'\xde\xad\xbe\xef'
+
+hx.convert("data", from_=hx.Text(), to=hx.Hex(prefix=True))
+# '0x64617461'
+
+hx.convert("π", from_=hx.Text(encoding="utf-8"), to=hx.Hex())
+# 'cf80'
+
+hx.convert("-_8", from_=hx.Base64(urlsafe=True, padding=False), to=hx.Hex())
+# 'fbff'
+```
+
+Old marker-style conversions still work:
+
+```python
+hx.convert("data", from_=hx.Text, to=hx.HexString)
+# '64617461'
+```
+
+## Composable pipelines
+
+Use `pipeline()` when you want a readable builder:
+
+```python
+conv = (
+    hx.pipeline()
+    .from_(hx.Hex())
+    .chunk(2)
+    .to(hx.IntArray(width=2))
+)
+
+conv("12345678")
+# [4660, 22136]
+```
+
+Use `>>` when you want compact composition:
+
+```python
+conv = hx.Hex() >> hx.Chunk(2) >> hx.HexArray()
+
+conv("12345678")
+# ['1234', '5678']
+```
+
+Available transforms:
+
+- `Chunk(width, strict=True)` / `Group(width, strict=True)` — set downstream grouping.
+- `Pad.left(width=..., byte=0)` / `Pad.right(block_size=..., byte=0)` — pad bytes.
+- `Reverse()` — reverse byte order.
+
+Examples:
+
+```python
+(hx.Hex() >> hx.Pad.left(width=4) >> hx.Hex())("dead")
+# '0000dead'
+
+(hx.Hex() >> hx.Reverse() >> hx.Hex())("deadbeef")
+# 'efbeadde'
+```
+
 ## Why explicit source helpers?
 
 Some inputs are impossible to infer safely:
@@ -113,6 +179,67 @@ conv([4660, 22136])
 # ['0x1234', '0x5678']
 ```
 
+## Extra formats
+
+Base encodings:
+
+```python
+hx.from_text("data").to(hx.Base32(padding=False))
+# 'MRQXIYI'
+
+hx.from_text("data").to(hx.Base85())
+# 'WMOn+'
+
+hx.from_text("data").to(hx.Ascii85())
+# 'A79Rg'
+```
+
+Escaped byte strings:
+
+```python
+hx.from_escaped(r"\xde\xad").hex
+# 'dead'
+
+hx.from_hex("dead").to(hx.Escaped())
+# '\\xde\\xad'
+```
+
+Hexdump:
+
+```python
+dump = hx.from_hex("deadbeef").to(hx.Hexdump(width=2))
+hx.from_hexdump(dump).hex
+# 'deadbeef'
+```
+
+Python `struct` packing/unpacking:
+
+```python
+hx.from_struct((0x1234, 0x5678), fmt=">HH").hex
+# '12345678'
+
+hx.from_hex("12345678").to(hx.Struct(">HH"))
+# (4660, 22136)
+```
+
+Bits:
+
+```python
+hx.from_bits([1, 0, 1]).hex
+# '05'
+
+hx.from_hex("05").to(hx.Bits())
+# [0, 0, 0, 0, 0, 1, 0, 1]
+```
+
+Automatic inference with explanations:
+
+```python
+result = hx.infer("0xdead")
+result.format, result.confidence, result.value.hex
+# (<class 'hexconv._core.HexString'>, 0.75, 'dead')
+```
+
 ## Supported source helpers
 
 - `from_bytes(value)`
@@ -126,7 +253,15 @@ conv([4660, 22136])
 - `from_text(value)`
 - `from_binary(value)`
 - `from_base64(value)`
+- `from_base32(value)`
+- `from_base85(value)`
+- `from_ascii85(value)`
+- `from_escaped(value)`
+- `from_hexdump(value)`
+- `from_struct(value, fmt=...)`
+- `from_bits(value)`
 - `from_auto(value)`
+- `infer(value)`
 
 ## Common output methods
 
@@ -142,4 +277,11 @@ conv([4660, 22136])
 - `to_text(encoding="ascii", errors="strict")`
 - `to_binary(sep="")`
 - `to_base64()`
+- `to_base32()`
+- `to_base85()`
+- `to_ascii85()`
+- `to_escaped()`
+- `to_hexdump()`
+- `to_struct(fmt)`
+- `to_bits()`
 - `to(format_marker, **options)`

{hexconv-0.1.1 → hexconv-0.2.0}/README.md

@@ -31,6 +31,72 @@ hx.from_int_array([0x1234, 0x5678], width=2).to_hex_array(width=2)
 # ['1234', '5678']
 ```
 
+## Configurable formats
+
+For reusable conversions, construct format specs with options:
+
+```python
+hx.convert("de ad be ef", from_=hx.Hex(), to=hx.Bytes())
+# b'\xde\xad\xbe\xef'
+
+hx.convert("data", from_=hx.Text(), to=hx.Hex(prefix=True))
+# '0x64617461'
+
+hx.convert("π", from_=hx.Text(encoding="utf-8"), to=hx.Hex())
+# 'cf80'
+
+hx.convert("-_8", from_=hx.Base64(urlsafe=True, padding=False), to=hx.Hex())
+# 'fbff'
+```
+
+Old marker-style conversions still work:
+
+```python
+hx.convert("data", from_=hx.Text, to=hx.HexString)
+# '64617461'
+```
+
+## Composable pipelines
+
+Use `pipeline()` when you want a readable builder:
+
+```python
+conv = (
+    hx.pipeline()
+    .from_(hx.Hex())
+    .chunk(2)
+    .to(hx.IntArray(width=2))
+)
+
+conv("12345678")
+# [4660, 22136]
+```
+
+Use `>>` when you want compact composition:
+
+```python
+conv = hx.Hex() >> hx.Chunk(2) >> hx.HexArray()
+
+conv("12345678")
+# ['1234', '5678']
+```
+
+Available transforms:
+
+- `Chunk(width, strict=True)` / `Group(width, strict=True)` — set downstream grouping.
+- `Pad.left(width=..., byte=0)` / `Pad.right(block_size=..., byte=0)` — pad bytes.
+- `Reverse()` — reverse byte order.
+
+Examples:
+
+```python
+(hx.Hex() >> hx.Pad.left(width=4) >> hx.Hex())("dead")
+# '0000dead'
+
+(hx.Hex() >> hx.Reverse() >> hx.Hex())("deadbeef")
+# 'efbeadde'
+```
+
 ## Why explicit source helpers?
 
 Some inputs are impossible to infer safely:
@@ -84,6 +150,67 @@ conv([4660, 22136])
 # ['0x1234', '0x5678']
 ```
 
+## Extra formats
+
+Base encodings:
+
+```python
+hx.from_text("data").to(hx.Base32(padding=False))
+# 'MRQXIYI'
+
+hx.from_text("data").to(hx.Base85())
+# 'WMOn+'
+
+hx.from_text("data").to(hx.Ascii85())
+# 'A79Rg'
+```
+
+Escaped byte strings:
+
+```python
+hx.from_escaped(r"\xde\xad").hex
+# 'dead'
+
+hx.from_hex("dead").to(hx.Escaped())
+# '\\xde\\xad'
+```
+
+Hexdump:
+
+```python
+dump = hx.from_hex("deadbeef").to(hx.Hexdump(width=2))
+hx.from_hexdump(dump).hex
+# 'deadbeef'
+```
+
+Python `struct` packing/unpacking:
+
+```python
+hx.from_struct((0x1234, 0x5678), fmt=">HH").hex
+# '12345678'
+
+hx.from_hex("12345678").to(hx.Struct(">HH"))
+# (4660, 22136)
+```
+
+Bits:
+
+```python
+hx.from_bits([1, 0, 1]).hex
+# '05'
+
+hx.from_hex("05").to(hx.Bits())
+# [0, 0, 0, 0, 0, 1, 0, 1]
+```
+
+Automatic inference with explanations:
+
+```python
+result = hx.infer("0xdead")
+result.format, result.confidence, result.value.hex
+# (<class 'hexconv._core.HexString'>, 0.75, 'dead')
+```
+
 ## Supported source helpers
 
 - `from_bytes(value)`
@@ -97,7 +224,15 @@ conv([4660, 22136])
 - `from_text(value)`
 - `from_binary(value)`
 - `from_base64(value)`
+- `from_base32(value)`
+- `from_base85(value)`
+- `from_ascii85(value)`
+- `from_escaped(value)`
+- `from_hexdump(value)`
+- `from_struct(value, fmt=...)`
+- `from_bits(value)`
 - `from_auto(value)`
+- `infer(value)`
 
 ## Common output methods
 
@@ -113,4 +248,11 @@ conv([4660, 22136])
 - `to_text(encoding="ascii", errors="strict")`
 - `to_binary(sep="")`
 - `to_base64()`
+- `to_base32()`
+- `to_base85()`
+- `to_ascii85()`
+- `to_escaped()`
+- `to_hexdump()`
+- `to_struct(fmt)`
+- `to_bits()`
 - `to(format_marker, **options)`

{hexconv-0.1.1 → hexconv-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hexconv"
-version = "0.1.1"
+version = "0.2.0"
 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.1.1 → hexconv-0.2.0}/src/hexconv/__init__.py

@@ -3,73 +3,139 @@
 from ._core import (
     ASCIIText,
     Auto,
+    AutoResult,
+    Ascii85,
+    Ascii85String,
     Base64String,
+    Base64,
+    Base32,
+    Base32String,
+    Base85,
+    Base85String,
     BinaryString,
+    Binary,
+    BitArray,
+    Bits,
     Bytes,
     BytesArray,
     BytesString,
+    Chunk,
     Converter,
     DecimalInt,
     DecimalIntArray,
+    Escaped,
+    EscapedString,
+    Group,
+    Hex,
     HexArray,
     HexConvError,
+    HexDump,
+    Hexdump,
     HexInt,
     HexNumbersArray,
     HexString,
     Int,
     IntArray,
     LargeHexNumber,
+    Pad,
+    Pipeline,
     RawString,
+    Reverse,
+    Struct,
+    StructFormat,
     Text,
+    Transform,
     Value,
     convert,
+    from_ascii85,
     from_auto,
+    from_base32,
     from_base64,
+    from_base85,
     from_binary,
+    from_bits,
     from_bytes,
     from_bytes_array,
     from_bytes_string,
+    from_escaped,
     from_hex,
     from_hex_array,
     from_hex_int,
+    from_hexdump,
     from_int,
     from_int_array,
+    from_struct,
     from_text,
+    infer,
+    pipeline,
 )
 
 __all__ = [
     "ASCIIText",
     "Auto",
+    "AutoResult",
+    "Ascii85",
+    "Ascii85String",
+    "Base32",
+    "Base32String",
     "Base64String",
+    "Base64",
+    "Base85",
+    "Base85String",
+    "Binary",
     "BinaryString",
+    "BitArray",
+    "Bits",
     "Bytes",
     "BytesArray",
     "BytesString",
+    "Chunk",
     "Converter",
     "DecimalInt",
     "DecimalIntArray",
+    "Escaped",
+    "EscapedString",
+    "Group",
+    "Hex",
     "HexArray",
     "HexConvError",
+    "HexDump",
+    "Hexdump",
     "HexInt",
     "HexNumbersArray",
     "HexString",
     "Int",
     "IntArray",
     "LargeHexNumber",
+    "Pad",
+    "Pipeline",
     "RawString",
+    "Reverse",
+    "Struct",
+    "StructFormat",
     "Text",
+    "Transform",
     "Value",
     "convert",
+    "from_ascii85",
     "from_auto",
+    "from_base32",
     "from_base64",
+    "from_base85",
     "from_binary",
+    "from_bits",
     "from_bytes",
     "from_bytes_array",
     "from_bytes_string",
+    "from_escaped",
     "from_hex",
     "from_hex_array",
     "from_hex_int",
+    "from_hexdump",
     "from_int",
     "from_int_array",
+    "from_struct",
     "from_text",
+    "infer",
+    "pipeline",
 ]