hwt.pyUtils package

This package contains python utils used in this library.

Submodules

hwt.pyUtils.arrayQuery module

exception hwt.pyUtils.arrayQuery.DuplicitValueExc

Bases: Exception

Exception which means that there are multiple items which this query selected but it should return only one

exception hwt.pyUtils.arrayQuery.NoValueExc

Bases: Exception

Exception which means that query did not selected any item

hwt.pyUtils.arrayQuery.areSetsIntersets(setA: set, setB: set)

Check if intersection of sets is not empty

hwt.pyUtils.arrayQuery.arr_all(iterable, fn)

Returns:

True if fn(item) for all items in interable or iterable is empty else False

hwt.pyUtils.arrayQuery.arr_any(iterable, fn)

Returns:

True if fn(item) for any item else False

hwt.pyUtils.arrayQuery.balanced_reduce(arr: Sequence, opFn)

hwt.pyUtils.arrayQuery.flatten(iterables, level=inf)

Flatten nested lists, tuples, generators and maps

Parameters:

level – maximum depth of flattening

hwt.pyUtils.arrayQuery.groupedby(collection, fn)

same like itertools.groupby

Note:

This function does not needs initial sorting like itertools.groupby

Attention:

Order of pairs is not deterministic.

hwt.pyUtils.arrayQuery.grouper(n: int, iterable: Sequence, padvalue=None)

grouper(3, ‘abcdefg’, ‘x’) –> (‘a’,’b’,’c’), (‘d’,’e’,’f’), (‘g’,’x’,’x’)

hwt.pyUtils.arrayQuery.single(iterable, fn)

Get value from iterable where fn(item) and check if there is not fn(other item)

Raises:

• DuplicitValueExc – when there are multiple items satisfying fn()

• NoValueExc – when no value satisfying fn(item) found

hwt.pyUtils.arrayQuery.take(iterrable, howMay)

Returns:

generator of first n items from iterrable

hwt.pyUtils.arrayQuery.where(iterable, fn)

Returns:

generator of items from iterable where fn(item)

hwt.pyUtils.fileHelpers module

hwt.pyUtils.fileHelpers.find_files(directory, pattern, recursive=True)

Find files by pattern in directory

hwt.pyUtils.setDeque module

class hwt.pyUtils.setDeque.SetDeque(initSeq: Sequence[T] | None = None)

Bases: Generic[T], deque

Deque of unique items

See:

https://docs.python.org/3/tutorial/datastructures.html

__init__(initSeq: Sequence[T] | None = None)

_get_set() → set[T]

append(item: T) → bool

Returns:

True if the item was newly added

clear()

Remove all elements from the deque.

copy()

Return a shallow copy of a deque.

discard(item: T) → bool

Returns:

True if the item was previously in this deque

extend(items: Sequence[T])

Extend the right side of the deque with elements from the iterable

insert(i: int, x: T)

D.insert(index, object) – insert object before index

intersection_set(other: set[T])

pop(*args, **kwargs) → T

Remove and return the rightmost element.

popleft() → T

Remove and return the leftmost element.

remove(item: T)

D.remove(value) – remove first occurrence of value.

hwt.pyUtils.setList module

class hwt.pyUtils.setList.SetList(initSeq: Sequence[T] | None = None)

Bases: Generic[T], list

List of unique items

See:

https://docs.python.org/3/tutorial/datastructures.html

__init__(initSeq: Sequence[T] | None = None)

_get_set() → set[T]

append(item: T) → bool

Returns:

True if the item was newly added

clear()

Remove all items from list.

copy()

Return a shallow copy of the list.

discard(item: T) → bool

Returns:

True if the item was previously in this list

extend(items: Sequence[T])

Extend list by appending elements from the iterable.

insert(i: int, x: T)

Insert object before index.

intersection_set(other: set[T])

pop(*args, **kwargs) → T

Remove and return item at index (default last).

Raises IndexError if list is empty or index is out of range.

remove(item: T)

Remove first occurrence of value.

Raises ValueError if the value is not present.

hwt.pyUtils.testUtils module

class hwt.pyUtils.testUtils.TestMatrix(*args, **kwargs)

Bases: object

Class which instance is a decorator which executes unittest.TestCase test method with every combination of argumets

__init__(*args, **kwargs)

Note:

args, kwargs are lists of arguments which should be passed as a test arguments

split_args_kwargs(args)

hwt.pyUtils.typingFuture module

hwt.pyUtils.typingFuture.override(method)

Check that the method overrides the parent method. A temporal supplement for typing.override from python3.12

Inspired by https://stackoverflow.com/questions/1167617/in-python-how-do-i-indicate-im-overriding-a-method