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
    
.. |travis| image:: https://travis-ci.org/goulu/Goulib.png?branch=master
    :target: https://travis-ci.org/goulu/Goulib

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:`piecewise`: piecewise-defined functions
- :mod:`polynomial`: polynomials (branch of `Rick Muller's reciepe <http://code.activestate.com/recipes/362193-manipulate-simple-polynomials-in-python/>`_)
- :mod:`motion` : generation of motion laws

- :mod:`table` : Table class with Excel + 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

- :mod:`geom` : 2D geometry
- :mod:`dxf2img` : Rasters (simple) .dxf (Autocad) files to bitmap images

- :mod:`optim` : Optimization algorithms

  Travelling Salesman Problem (TSP) hill climbing + simulated annealing 

- :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.


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

:tests status: |travis|

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

- :mod:`dxf2img` needs `dxfgrabber <http://pypi.python.org/pypi/dxfgrabber/>`_ and `pillow <http://pypi.python.org/pypi/pillow/>`_
  (Pillow is prefered over PIL because of Travis CI tests)
- :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/>`_