Goulib
======

My Python library of useful code found and written for various projects

:author: Philippe Guglielmetti goulib@goulu.net |endorse|
:copyright: Copyright 2013 Philippe Guglielmetti
:license: LGPL (see LICENSE.TXT)

.. |endorse| image:: https://api.coderwall.com/goulu/endorsecount.png
    :target: https://coderwall.com/goulu

Modules
-------
.. toctree::
   :hidden:
   :glob:
   
   modules/*
   
- :mod:`datetime2` : additions to :mod:`datetime`
- :mod:`itertools2` : additions to :mod:`itertools`
- :mod:`math2` : additions to :mod:`math` standard library

- :mod:`interval` : operations on [x..y[ intervals
- :mod:`optim` : Optimization algorithms

  Travelling Salesman Problem (TSP) hill climbing + simulated annealing 

- :mod:`dxf2img` : rasters (simple) .dxf files to bitmap images
- :mod:`markup` : simple HTML output (branch of `markup <http://pypi.python.org/pypi/markup/>`_ )
- :mod:`nvd3` : generates Javascript charts using http://nvd3.org and http://d3js.org

  Obsolete. use `python-nvd3 <http://pypi.python.org/pypi/python-nvd3/>`_ which is derived from this module.

- :mod:`table` : Table class with CSV I/O, easy access to columns, HTML output
- :mod:`workdays` : WorkCalendar class with datetime operations on working hours

  merges and improves `BusinessHours <http://pypi.python.org/pypi/BusinessHours/>`_ and `workdays <http://pypi.python.org/pypi/workdays/>`_ packages
- :mod:`colors` : web (hex) colors dictionary and related functions

Requirements
------------
Goulib uses only standard Python libs, except:

- :mod:`dxf2img` needs `dxfgrabber <http://pypi.python.org/pypi/dxfgrabber/>`_ and `pil <http://pypi.python.org/pypi/pil/>`_
- :meth:`~table.Table.read_xls` needs `xlrd <http://pypi.python.org/pypi/xlrd/>`_

automated `nose <http://pypi.python.org/pypi/nose/>`_ tests generated by `pythoscope <http://pypi.python.org/pypi/pythoscope/>`_


Resources
---------
:installation: "pip install Goulib"

:distribution: https://pypi.python.org/pypi/Goulib

:documentation: https://goulib.readthedocs.org/
:source: https://github.com/goulu/Goulib
:changelog: https://github.com/goulu/goulib/blob/master/CHANGES.rst

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

History
-------
.. include:: ..\CHANGES.rst