python-utils

Python Utils is a collection of small Python functions and classes which make common patterns shorter and easier. It is by no means a complete collection but it has served me quite a bit in the past and I will keep extending it.

One of the libraries using Python Utils is Django Utils.

Documentation is available at: https://python-utils.readthedocs.org/en/latest/

Links

The source: https://github.com/WoLpH/python-utils

Project page: https://pypi.python.org/pypi/python-utils

Reporting bugs: https://github.com/WoLpH/python-utils/issues

Documentation: https://python-utils.readthedocs.io/en/latest/

My blog: https://wol.ph/

Requirements for installing:

six any recent version

Installation:

The package can be installed through pip (this is the recommended method):

pip install python-utils

Or if pip is not available, easy_install should work as well:

easy_install python-utils

Or download the latest release from Pypi (https://pypi.python.org/pypi/python-utils) or Github.

Note that the releases on Pypi are signed with my GPG key (https://pgp.mit.edu/pks/lookup?op=vindex&search=0xE81444E9CE1F695D) and can be checked using GPG:

gpg –verify python-utils-<version>.tar.gz.asc python-utils-<version>.tar.gz

Quickstart

This module makes it easy to execute common tasks in Python scripts such as converting text to numbers and making sure a string is in unicode or bytes format.

Examples

To extract a number from nearly every string:

from python_utils import converters

number = converters.to_int('spam15eggs')
assert number == 15

number = converters.to_int('spam')
assert number == 0

number = converters.to_int('spam', default=1)
assert number == 1

number = converters.to_float('spam1.234')

To do a global import programmatically you can use the import_global function. This effectively emulates a from … import *

from python_utils.import_ import import_global

# The following is  the equivalent of `from some_module import *`
import_global('some_module')

Or add a correclty named logger to your classes which can be easily accessed:

class MyClass(Logged):
    def __init__(self):
        Logged.__init__(self)

my_class = MyClass()

# Accessing the logging method:
my_class.error('error')

# With formatting:
my_class.error('The logger supports %(formatting)s',
               formatting='named parameters')

# Or to access the actual log function (overwriting the log formatting can
# be done n the log method)
import logging
my_class.log(logging.ERROR, 'log')

Metadata

Release files for python-utils 2.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-utils 2.5.0
File	Size	Uploaded
python-utils-2.5.0.tar.gz	115.3 kB	Jan 15, 2021	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-utils 2.5.0
File	Interpreter	ABI	Platform	Reset
python_utils-2.5.0-py2.py3-none-any.whl 13.7 kB Jan 15, 2021	Python 3, Python 2	none	any	Details

Total release size: 129.0 kB

Release files / python-utils-2.5.0.tar.gz

Download URL	python-utils-2.5.0.tar.gz
Size	115.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`c43705696ced0d0e36124a5df2098500fc2f3527f4f2c4f1583f3c50af36671e`
BLAKE2b-256 checksum How to use checksums	`67ade42da3534f037a732dcb2e7ad4b52ee30b17be4c7d4518713ad17f9aac58`
Upload date	Jan 15, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`Python-urllib/3.8`

Release files / python_utils-2.5.0-py2.py3-none-any.whl

Download URL	python_utils-2.5.0-py2.py3-none-any.whl
Size	13.7 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`8a9b97097e04766fb2955cd59728bc4467f1eb5f193709552779c27ec4c1d6ac`
BLAKE2b-256 checksum How to use checksums	`96fb00f8935f681d6d0f74b78b30f97dbb98f879b59b7f69d2d37cc71ad7b6ce`
Upload date	Jan 15, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`Python-urllib/3.8`