diff options
| -rw-r--r-- | README | 97 | ||||
| -rw-r--r-- | docs/index.rst | 97 |
2 files changed, 97 insertions, 97 deletions
@@ -37,103 +37,6 @@ For installation options, see :: python setup.py install --help -Provided modules ----------------- - -Here is a brief description of the available modules. - -Modules providing high-level features -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* :ref:`cache <cache>`, a cache implementation with a least recently used algorithm. - -* :ref:`changelog <changelog>`, a tiny library to manipulate our simplified ChangeLog file format. - -* :ref:`clcommands <clcommands>`, high-level classes to define command line programs handling - different subcommands. It is based on `configuration` to get easy command line - / configuration file handling. - -* :ref:`configuration <configuration>`, some classes to handle unified configuration from both - command line (using optparse) and configuration file (using ConfigParser). - -* :ref:`proc <proc>`, interface to Linux /proc. - -* :ref:`umessage <umessage>`, unicode email support. - -* :ref:`ureports <ureports>`, micro-reports, a way to create simple reports using python objects - without care of the final formatting. ReST and html formatters are provided. - - -Modules providing low-level functions and structures -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* :ref:`compat <compat>`, provides a transparent compatibility layer between different python - versions. - -* :ref:`date <date>`, a set of date manipulation functions. - -* :ref:`daemon <daemon>`, a daemon function and mix-in class to properly start an Unix daemon - process. - -* :ref:`decorators <decorators>`, function decorators such as cached, timed... - -* :ref:`deprecation <deprecation>`, decorator, metaclass & all to mark functions / classes as - deprecated or moved - -* :ref:`fileutils <fileutils>`, some file / file path manipulation utilities. - -* :ref:`graph <graph>`, graph manipulations functions such as cycle detection, bases for dot - file generation. - -* :ref:`modutils <modutils>`, python module manipulation functions. - -* :ref:`shellutils <shellutils>`, some powerful shell like functions to replace shell scripts with - python scripts. - -* :ref:`tasksqueue <tasksqueue>`, a prioritized tasks queue implementation. - -* :ref:`textutils <textutils>`, some text manipulation functions (ansi colorization, line wrapping, - rest support...). - -* :ref:`tree <tree>`, base class to represent tree structure, and some others to make it - works with the visitor implementation (see below). - -* :ref:`visitor <visitor>`, a generic visitor pattern implementation. - - -Modules extending some standard modules -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* :ref:`debugger <debugger>`, `pdb` customization. - -* :ref:`logging_ext <logging_ext>`, extensions to `logging` module such as a colorized formatter - and an easier initialization function. - -* :ref:`optik_ext <optik_ext>`, defines some new option types (regexp, csv, color, date, etc.) - for `optik` / `optparse` - - -Modules extending some external modules -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* :ref:`sphinx_ext <sphinx_ext>`, Sphinx_ plugin defining a `autodocstring` directive. - -* :ref:`vcgutils <vcgutils>` , utilities functions to generate file readable with Georg Sander's - vcg tool (Visualization of Compiler Graphs). - - -To be deprecated modules -~~~~~~~~~~~~~~~~~~~~~~~~ - -Those `logilab.common` modules will much probably be deprecated in future -versions: - -* `testlib`: use `unittest2`_ 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) - - Building the documentation -------------------------- diff --git a/docs/index.rst b/docs/index.rst index 47d17ab..a506420 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -5,6 +5,103 @@ .. include:: ../README +Provided modules +---------------- + +Here is a brief description of the available modules. + +Modules providing high-level features +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* :ref:`cache <cache>`, a cache implementation with a least recently used algorithm. + +* :ref:`changelog <changelog>`, a tiny library to manipulate our simplified ChangeLog file format. + +* :ref:`clcommands <clcommands>`, high-level classes to define command line programs handling + different subcommands. It is based on `configuration` to get easy command line + / configuration file handling. + +* :ref:`configuration <configuration>`, some classes to handle unified configuration from both + command line (using optparse) and configuration file (using ConfigParser). + +* :ref:`proc <proc>`, interface to Linux /proc. + +* :ref:`umessage <umessage>`, unicode email support. + +* :ref:`ureports <ureports>`, micro-reports, a way to create simple reports using python objects + without care of the final formatting. ReST and html formatters are provided. + + +Modules providing low-level functions and structures +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* :ref:`compat <compat>`, provides a transparent compatibility layer between different python + versions. + +* :ref:`date <date>`, a set of date manipulation functions. + +* :ref:`daemon <daemon>`, a daemon function and mix-in class to properly start an Unix daemon + process. + +* :ref:`decorators <decorators>`, function decorators such as cached, timed... + +* :ref:`deprecation <deprecation>`, decorator, metaclass & all to mark functions / classes as + deprecated or moved + +* :ref:`fileutils <fileutils>`, some file / file path manipulation utilities. + +* :ref:`graph <graph>`, graph manipulations functions such as cycle detection, bases for dot + file generation. + +* :ref:`modutils <modutils>`, python module manipulation functions. + +* :ref:`shellutils <shellutils>`, some powerful shell like functions to replace shell scripts with + python scripts. + +* :ref:`tasksqueue <tasksqueue>`, a prioritized tasks queue implementation. + +* :ref:`textutils <textutils>`, some text manipulation functions (ansi colorization, line wrapping, + rest support...). + +* :ref:`tree <tree>`, base class to represent tree structure, and some others to make it + works with the visitor implementation (see below). + +* :ref:`visitor <visitor>`, a generic visitor pattern implementation. + + +Modules extending some standard modules +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* :ref:`debugger <debugger>`, `pdb` customization. + +* :ref:`logging_ext <logging_ext>`, extensions to `logging` module such as a colorized formatter + and an easier initialization function. + +* :ref:`optik_ext <optik_ext>`, defines some new option types (regexp, csv, color, date, etc.) + for `optik` / `optparse` + + +Modules extending some external modules +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +* :ref:`sphinx_ext <sphinx_ext>`, Sphinx_ plugin defining a `autodocstring` directive. + +* :ref:`vcgutils <vcgutils>` , utilities functions to generate file readable with Georg Sander's + vcg tool (Visualization of Compiler Graphs). + + +To be deprecated modules +~~~~~~~~~~~~~~~~~~~~~~~~ + +Those `logilab.common` modules will much probably be deprecated in future +versions: + +* `testlib`: use `unittest2`_ 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) + + .. _Sphinx: http://sphinx.pocoo.org/ .. _`unittest2`: http://pypi.python.org/pypi/unittest2 .. _`discover`: http://pypi.python.org/pypi/discover |