Skip to main content

Python Utils is a module with some convenient utilities not included with the standard Python install

Project description

https://travis-ci.org/WoLpH/python-utils.png?branch=master https://coveralls.io/repos/WoLpH/python-utils/badge.png?branch=master

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: http://python-utils.readthedocs.org/en/latest/

Requirements for installing:

  • six any recent version

Installation:

pip install python-utils

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')

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-utils-2.0.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

python_utils-2.0.1-py2.py3-none-any.whl (9.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file python-utils-2.0.1.tar.gz.

File metadata

File hashes

Hashes for python-utils-2.0.1.tar.gz
Algorithm Hash digest
SHA256 985f44edf24918d87531c339f8b126ce2d303cbbc9a4c7fc4dc81ac0726079ff
MD5 107beb80b432db995614cb4de5ad7fdd
BLAKE2b-256 46e860bc82e7bb5d9e326c4691ed73e02a2a0e3ce6bb7adefd8cb2d9d8456b3a

See more details on using hashes here.

File details

Details for the file python_utils-2.0.1-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_utils-2.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 670f9b992ebfc005329fd9740408f2a704e595d64c8f8da83f7977618dba4acc
MD5 dcf70d4b5b14b9aa8475e01c64adb81b
BLAKE2b-256 a6d9b0b61984fa66ec63d9510d10e1bdf20a2314110f37e5e0fd036bc97befdd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page