qtils 0.9.4

Qtils - pronounces as `cuteels` - is a syntactic sugar library to make sweet Python coding even sweeter.

---

Overview

Qtils - pronounces as cuteels - is a syntactic sugar library to make sweet Python coding even sweeter.

Dedication

This library is dedicated to Pál Hubai, Surfy, my programming Master who spent countless hours answering my questions, providing code examples, and guiding me towards the right approach when I was learning programming as a child. Thank you!

Documentation

• Documentation is available at https://qtils.readthedocs.io/en/latest/

• See examples and usage in examples and tutorials

Features

• Convenient collections qdict, qlist and QEnum

• Self-formatting object in PrettyObject

• Two-way formatter/parser for file sizes, for example ‘5.4 GB’, in DataSize

• Weak reference property decorator weakproperty

• Cached property decorator cachedproperty

• Class logger decorator logged

• Common string transformations in qtils.string_utils

Installation

Qtils is available in PyPI:

$ pip install qtils

Examples

Attribute dictionary

>>> from qtils import *

>>> d = qdict()
>>> d.hello = "world"
>>> d.hello
'world'
>>> d.answer = 42
>>> d['answer']
42

Objects with self-formatting capability

>>> class MyObject(PrettyObject):
...     __pretty_fields__ = [
...         'hello',
...         'answer',
...     ]
...     def __init__(self, hello, answer):
...         self.hello = hello
...         self.answer = answer
>>> obj = MyObject('world', 42)
>>> print(obj)
<__main__.MyObject object at ... hello='world', answer=42>

Cached property

>>> class Foo(object):
...     @cachedproperty
...     def bar(self):
...         # doing some super computation-intensive thing here
...         print('getter called')
...         return "hello world"
...
>>> obj = Foo()
>>> obj.bar     # first call, getter is called
getter called
'hello world'
>>> obj.bar     # second call, getter is not called
'hello world'
>>> del obj.bar # removing cached value
>>> obj.bar     # getter is called again
getter called
'hello world'

Formatting and parsing file sizes

>>> print(DataSize(123000))
123 k
>>> DataSize('1.45 megabytes')
1450000
>>> DataSize('1T').format(unit="k", number_format="{:,.0f} {}")
'1,000,000,000 k'

Adding a class-private logger

>>> @logged
... class LoggedFoo():
...     def __init__(self):
...         self.__logger.info("Hello World from Foo!")
...

See more examples and usage in examples and tutorials.

Contribution

Pull requests are always welcome.