utcw

Shared utilities for the two-letter packages.

pip install utcw

utcw holds the common code that several of the two-letter packages (fg, iy, kw, lh, nh, ow, xl, ya, yf, ys, yw, yx, yz, zr) depend on. Those packages previously reached for this code through a toolbox that was never published, which meant they could be installed but not imported. utcw gives that code a real home on PyPI.

Layout

Modules are grouped by what they operate on:

Examples

>>> from utcw.pcoll.order_conserving import intersect, setdiff
>>> intersect([1, 2, 3, 4], [3, 1])
[1, 3]
>>> setdiff([1, 2, 3], [2])
[1, 3]

>>> from utcw.pstr.trans import toascii, strip
>>> toascii('café crème')
'cafe creme'
>>> strip('  a   b  ')
'a b'

>>> from utcw.pdict.manip import rollout
>>> rollout({'a': [{'x': 1}, {'x': 2}], 'b': 'B'}, 'a')
[{'a.x': 1, 'b': 'B'}, {'a.x': 2, 'b': 'B'}]

>>> import pandas as pd
>>> from utcw.daf.get import rows_with_col_values_in
>>> df = pd.DataFrame({'a': [1, 2, 3], 'b': list('xyz')})
>>> rows_with_col_values_in(df, 'a', [1, 3])['b'].tolist()
['x', 'z']

Notes

This is vendored code, extracted as the transitive closure of what the two-letter packages actually reference — not a curated library. It is published so those packages can declare a real dependency instead of an unsatisfiable one. Expect the API to be stable (nothing new depends on it) rather than polished.

Two Python-2-era breakages were repaired during extraction: utcw.pfile.to.string used the removed file() builtin, and utcw.parse.util.x_to_soup reached it through a module-level name that no longer resolved.