b3j0f.conf 0.1

pyton class configuration tools useful in python projects.

Description

Common tools useful to python projects.

Links

• Homepage

• PyPI

• Documentation

Installation

pip install b3j0f.conf

Features

This library provides a set of class configuration tools in order to ease development of systems based on configuration resources such as files, DB documents, etc.

The main class is b3j0f.conf.configurable

Configurable classes are provided in order to be synced with configuration resources which respect two levels and are agnostic from configuration languages.

Both levels respect the first known configuration format which is ini.

Therefore, you may define a category which is associated to options.

A configurable can be bound to a several categories, which contain several options such as couple of property name and value.

• chaining: chain object methods calls in a dedicated Chaining object. Such method calls return the Chaining object itself, allowing multiple calls to object methods to be invoked in a concise statement.

• 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.conf.chaining import Chaining, ListChaining
>>> c = Chaining("te").__iadd__("s").__iadd__("t")
>>> # display content of Chaining
>>> c._
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.conf.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.conf.path import lookup, getpath
>>> getpath(lookup)
"b3j0f.conf.path.lookup"
>>> getpath(lookup("b3j0f.conf.path.getpath"))
"b3j0f.conf.path.getpath"

Property

>>> from b3j0f.conf.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.conf.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.conf.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

• wait feedbacks during 6 months before passing it to a stable version.

• Cython implementation.

ChangeLog

0.8.5 (02/16/15)

• Add proxy module.

Donation