byte-util 0.1.0__tar.gz

byte_util-0.1.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: byte-util
+Version: 0.1.0
+Summary: Utility functions for converting bytes and bytearrays to various formats
+Author: Adam Blakney
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

byte_util-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "byte-util"
+version = "0.1.0"
+description = "Utility functions for converting bytes and bytearrays to various formats"
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+  {name = "Adam Blakney"}
+]
+
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

byte_util-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

byte_util-0.1.0/src/byte_util/__init__.py

@@ -0,0 +1,3 @@
+from .convert import hex, ranged_int, custom_chars, ascii, alpha_numeric, alpha_numeric_case_sensitive, decimal
+
+__all__ = ['hex', 'ranged_int', 'custom_chars', 'ascii', 'alpha_numeric', 'alph_numeric_case_sensitive', 'decimal']

byte_util-0.1.0/src/byte_util/convert.py

@@ -0,0 +1,88 @@
+''' helper methods '''
+
+ALPHA_LOWER = 'abcdefghijklmnopqrstuvwxyz'
+ALPHA_UPPER = ALPHA_LOWER.upper()
+DIGITS = '0123456789'
+SYMBOLS = '~!@#$%^&*()-_=+[{]}|;:\'\",<.>/?'
+
+# return hexadecimal string from bytes
+def hex(b: bytes | bytearray) -> str:
+  return b.hex()
+
+# random in in range [a, b)
+# using the "division with rejection" method from here: 
+# https://www.pcg-random.org/posts/bounded-rands.html
+# return None if sample fails
+def ranged_int(_bytes: bytes | bytearray, a: int, b: int) -> int:
+
+  if b <= a:
+    raise BaseException('invalid range')
+
+  i = int.from_bytes(_bytes, byteorder='little')
+
+  _range = b - a 
+  _max = 2 ** (len(_bytes) * 8)
+
+  if _range > _max:
+    raise BaseException('not enough bytes to sample that range')
+
+  # this essentially finds which bin the number is in
+  # there are _range bins, each of size _max // _range
+  ret = (i // (_max // _range))
+
+  # reject if needed
+  if ret >= _range:
+    return None
+
+  # adjust to fit in range
+  return ret + a
+
+# return string containing random characters from l based on byte values
+# in b
+def custom_chars(b: bytes | bytearray, l: list) -> str:
+
+  n = len(l)
+  ret = ''
+
+  for i in range(len(b)):
+    r = ranged_int(b[i:i+1], 0, n)
+    if r is None:
+      continue
+    curr = l[r]
+    ret = '{}{}'.format(ret, curr)
+  
+  return ret
+
+# get ascii from bytearray
+def ascii(b: bytes | bytearray) -> str:
+  return custom_chars(b, ALPHA_LOWER + ALPHA_UPPER + DIGITS + SYMBOLS)
+
+# alphanumeric with lower case
+def alpha_numeric(b: bytes | bytearray) -> str:
+  return custom_chars(b, ALPHA_LOWER + DIGITS)  
+
+# alphanumeric thats case sensitive
+def alpha_numeric_case_sensitive(b: bytes | bytearray) -> str:
+  return custom_chars(b, ALPHA_LOWER + ALPHA_UPPER + DIGITS)  
+
+# digits from bytes
+def decimal(b: bytes | bytearray) -> str:
+  return custom_chars(b, DIGITS)
+
+# Helper method to convert bytes to different formats
+# take in bytes (s) and a format, output the bytes converted to the format
+def convert_bytes(s, _format):
+  if _format == 'hex':
+    return hex_from_bytes(s)
+  elif _format == 'ascii':
+    return ascii_from_bytes(s)
+  elif _format == 'alpha-numeric':
+    return alpha_numeric_from_bytes(s)
+  elif _format == 'Alpha-numeric':
+    return alpha_numeric_case_sensitive_from_bytes(s)
+  elif _format == 'digits':
+    return digits_from_bytes(s)
+  elif _format == 'bytes':
+    return s
+  else:
+    raise BaseException('invalid format type') 

byte_util-0.1.0/src/byte_util/test.py

@@ -0,0 +1,23 @@
+import convert
+
+chars = 'abjk243'
+
+b = bytearray()
+b.append(2)
+b.append(23)
+b.append(44)
+b.append(101)
+b.append(222)
+b.append(56)
+b.append(153)
+
+print(b)
+print(convert.hex(b))
+print(convert.ascii(b))
+print(convert.custom_chars(b, chars))
+print(convert.ranged_int(b, 0, 10))
+print(convert.alpha_numeric(b))
+print(convert.alpha_numeric_case_sensitive(b))
+print(convert.decimal(b))
+
+

byte_util-0.1.0/src/byte_util.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: byte-util
+Version: 0.1.0
+Summary: Utility functions for converting bytes and bytearrays to various formats
+Author: Adam Blakney
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown

byte_util-0.1.0/src/byte_util.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+src/byte_util/__init__.py
+src/byte_util/convert.py
+src/byte_util/test.py
+src/byte_util.egg-info/PKG-INFO
+src/byte_util.egg-info/SOURCES.txt
+src/byte_util.egg-info/dependency_links.txt
+src/byte_util.egg-info/top_level.txt

byte_util-0.1.0/src/byte_util.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

byte_util-0.1.0/src/byte_util.egg-info/top_level.txt

@@ -0,0 +1 @@
+byte_util