Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019

logilab-common (3)


logilab-common - Common Modules used by Logilab projects


Please see following description for synopsis


logilab-common(3)          Library Functions Manual          logilab-common(3)

       logilab-common - Common Modules used by Logilab projects

       The  logilab-common  package  contains  some  modules used by different
       Logilab projects.

Provided modules
       A brief description of the available modules:

Modules providing high-level features
       * `cache`, a cache implementation with a least recently used algorithm.

       * `changelog`, a tiny library to manipulate  our  simplified  ChangeLog
       file format.

       * `clcommands`, high-level classes to define command line programs han-
       dling different subcommands. It is based on `configuration` to get easy
       command line / configuration file handling.

       *  `configuration`,  some  classes to handle unified configuration from
       both command line (using optparse) and configuration file  (using  Con-

       * `proc`, interface to Linux /proc.

       * `umessage`, unicode email support.

       *  `ureports`,  micro-reports,  a  way  to  create simple reports using
       python objects without care of the final formatting. ReST and html for-
       matters are provided.

Modules providing low-level functions and structures
       *  `compat`, provides a transparent compatibility layer between differ-
       ent python versions.

       * `date`, a set of date manipulation functions.

       * `daemon`, a daemon function and mix-in class  to  properly  start  an
       Unix daemon process.

       * `decorators`, function decorators such as cached, timed...

       * `deprecation`, decorator, metaclass & all to mark functions / classes
       as deprecated or moved

       * `fileutils`, some file / file path manipulation utilities.

       * `graph`, graph manipulations functions such as cycle detection, bases
       for dot file generation.

       * `modutils`, python module manipulation functions.

       *  `shellutils`,  some  powerful  shell like functions to replace shell
       scripts with python scripts.

       * `tasksqueue`, a prioritized tasks queue implementation.

       * `textutils`, some text  manipulation  functions  (ansi  colorization,
       line wrapping, rest support...).

       *  `tree`,  base  class to represent tree structure, and some others to
       make it works with the visitor implementation (see below).

       * `visitor`, a generic visitor pattern implementation.

Modules extending some standard modules
       * `debugger`,  `pdb` customization.

       * `logging_ext`, extensions to `logging` module  such  as  a  colorized
       formatter and an easier initialization function.

       * `optik_ext`, defines some new option types (regexp, csv, color, date,
       etc.) for `optik` / `optparse`

Modules extending some external modules
       * `sphinx_ext`, Sphinx_ plugin defining a `autodocstring` directive.

       * `vcgutils` , utilities functions to generate file readable with Georg
       Sander's vcg tool (Visualization of Compiler Graphs).

To be deprecated modules
       These  `logilab.common`  modules  will probably be deprecated in future

       * `testlib`: use `unittest2`_ instead

       * `pytest`: use `discover`_ instead

       * `interface`: use `zope.interface`_ if you really want this

       * `table`, `xmlutils`: is that used?

       * `sphinxutils`: we won't go that way imo (i == syt)



                             logilab-common python modules

       Sylvain Thenault (sylvain.thenault@logilab.fr)

       Use the python-projects@lists.logilab.org mailing list. Since we do not
       have  publicly available bug tracker yet, bug reports should be emailed
       there too.

       You  can  subscribe  to  this  mailing   list   at   http://lists.logi-

       Archives  are  available  at http://lists.logilab.org/pipermail/python-

       See attributes(7) for descriptions of the following attributes:

       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE         |
       |Availability   | library/python/logilab-common |
       |Stability      | Uncommitted                   |
       astroid(3), pylint(1)

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source was downloaded from  pypi:///logilab-common==1.2.2

       Further information about this software can be found on the open source
       community website at http://www.logilab.org/project/logilab-common/.

logilab-common 1.2.2              23 Aug 2016                logilab-common(3)