Skip to main content

Set of tools and utilities useful in python projects

Project description

Common tools useful to python projects.

License Development Status Latest release Supported Python versions Supported Python implementations Download format Build status Code test coverage Downloads

Installation

pip install b3j0f.utils

Description

This library provides a set of generic tools in order to ease development of projects in python >= 2.6.

Provided tools are:

  • chaining: manage chaining of function call such as chaining execution in some javascript libraries like jquery or d3.

  • iterable: tools in order to manage iterable elements.

  • path: python object path resolver, from object to absolute/relative path or the inverse.

  • property: (un)bind/find properties in reflective and oop concerns.

  • reflect: tools which ease development with reflective concerns.

  • runtime: ease runtime execution.

  • proxy: create proxy (from design pattern) objects from a routine or an object which respects the signature and description of the proxified element.

  • ut: improve unit tests.

  • version: ease compatibility between python version (from 2.x to 3.x).

Examples

Chaining

>>> # add characters to a string in one line
>>> from b3j0f.utils.chaining import Chaining, ListChaining
>>> Chaining("te").__iadd__("s").__iadd__("t").content
"test"
>>> # call several strings operations on several strings and get operation results in one line
>>> ListChaining("Test", "Example").upper().lower()[:]
[["TEST", "EXAMPLE"], ["test", "example"]]

Iterable

>>> from b3j0f.utils.iterable import is_iterable, first
>>> is_iterable(1)
False
>>> is_iterable("aze")
True
>>> is_iterable("aze", exclude=str)
False
>>> first("aze")
"a"
>>> first("", default="test")
"test"

Path

>>> from b3j0f.utils.path import lookup, getpath
>>> getpath(lookup)
"b3j0f.utils.path.lookup"
>>> getpath(lookup("b3j0f.utils.path.getpath"))
"b3j0f.utils.path.getpath"

Property

>>> from b3j0f.utils.property import put_properties, get_properties, del_properties
>>> put_properties(min, {'test': True})
>>> get_properties(min)
{'test': True}
>>> del_properties(min)
>>> get_properties(min)
None

Reflect

>>> from b3j0f.utils.reflect import base_elts, is_inherited
>>> class BaseTest(object):
>>>     def test(self): pass
>>> class Test(BaseTest): pass
>>> class FinalTest(Test): pass
>>> base_elts(FinalTest().test, depth=1)[-1].im_class.__name__
Test
>>> base_elts(FinalTest().test)[-1].im_class.__name__
BaseTest
>>> is_inherited(FinalTest.test)
True
>>> is_inherited(BaseTest.test)
False

Proxy

>>> from b3j0f.utils.proxy import get_proxy, proxified_elt
>>> l = lambda: 2
>>> proxy = get_proxy(l, lambda: 3)
>>> proxy()
3
>>> assert proxified_elt(proxy) is l
True
>>> proxified_elt(proxy)()
2
>>> proxy = get_proxy(l)
>>> proxy()
2
>>> assert proxy is not l
>>> assert proxified_elt(proxy) is l

Perspectives

  • Cython implementation.

ChangeLog

0.8.5 (02/16/15)

  • Add proxy module.

Donating

I'm grateful for gifts, but don't have a specific funding goal.

Project details


Download files

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

Source Distributions

b3j0f.utils-0.8.5.zip (51.5 kB view hashes)

Uploaded Source

b3j0f.utils-0.8.5.tar.gz (26.4 kB view hashes)

Uploaded Source

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