py-utls

Utilities for Python

py-utls is a small Python repository where I put all the useful stuff I regularly need in my projects.
Feel free to use at your discretion with the appropriate license mentions.

NB: I've developed the same kind of libraries for both Go and TypeScript.

Usage

pip install py-utls

This repository contains the following modules:

• hex:
  • from_hex: builds the byte array from a string;
  • to_hex: creates the hexadecimal representation of a byte array;
• list:
  • chunk: split a list into chunks of a maximum size;
  • flatten: transforms a list of list of items to a list of items;
• number:
  • euclidean_division: compute the euclidean division of the passed integers.

from pyutls.hex import from_hex, to_hex
from pyutls.list import chunk, flatten
from pyutls.number import euclidean_division

# Hex utilities
barray = from_hex('1234abcd')
hex_string = to_hex(barray)
assertEqual(hex_string == '1234abcd')

# Flatten a list of list
chunks = chunk(some_list, size)
flat_list = flatten(chunks)
assertListEqual(flat_list == some_list)

# Euclidean division
quotient, remainder = euclidean_division(numerator, denominator)
assertEqual(quotient * denominator + remainder == numerator)

It also constains a CustomLogger class (see its documentation for usage):

import logging
from pyutls import CustomLogger

logger = CustomLogger(level=logging.DEBUG)
logger.with_time("This test line should appear in test logs!", logging.INFO)

Tests

Eventually, add a setup step:

$ git clone https://github.com/cyrildever/py-utls.git
$ cd py-utls/
$ python3 -m venv venv
$ source venv/bin/activate
$ pip install build twine setuptools

Then, proceed to testing:

$ python3 -m unittest discover

License

These modules are distributed under a MIT license.
See the LICENSE file.