README

Links:

• pypi/pyquickhelper
• GitHub/pyquickhelper
• documentation
• Windows Setup

Description

This extension gathers three functionalities:

• a logging function: fLOG <loghelper.flog.fLOG>
• a function to synchronize two folders: synchronize_folder <sync.synchelper.synchronize_folder>
• a function to generate a copy of a module, converting doxygen documentation in rst format: generate_help_sphinx <helpgen.sphinx_main.generate_help_sphinx> (see also prepare_file_for_sphinx_help_generation <helpgen.utils_sphinx_doc.prepare_file_for_sphinx_help_generation>), it requires the module is designed as this one (src, _doc folders).

The module is available on pypi/pyquickhelper and on GitHub/pyquickhelper.

Functionalities

• help generation
• folder synchronization
• logging
• import a flat file into a SQLite database
• help running unit tests
• functions to convert a pandas DataFrame into a HTML table or a RST table

Design

This project contains various helper about logging functions, unit tests and help generation.

• a source folder: src
• a unit test folder: _unittests, go to this folder and run run_unittests.py
• a _doc folder: _doc, it will contains the documentation
• a file setup.py to build and to install the module
• a file make_help.py to build the sphinx documentation

Versions

• 0.7 - 2014/??/??

  • new: function has_been_updated <sync.synchelper.has_been_updated> to check a copy of a file is outdated
  • fix: fix a bug while updating the notebook file (documentation generation)

• 0.6 - 2014/08/24

  • change: minor fixes for the documentation generation
  • add: add code to handle conversion of notebooks in docx format

• v0.5 - 2014/08/05

  • change: few fixes while generating the documentation (notebooks, toctrees)
  • change: compilation of the help into PDF, latex, singlehtml
  • change: removes the creation of temp_log.txt by default when using function fLOG <loghelper.flog.fLOG>
  • fix: the module can fix an exception thrown by pywin32 about DLL missing
  • change: can use nbconvert from ipython 2.1 to generate the documentation
  • new: add function get_url_content <loghelper.url_helper.get_url_content>
  • new: add function noLOG <loghelper.flog.noLOG> which does nothing (disable the logs)
  • fix: fix path to local images in notebooks
  • change: the help generation can now produce multiple layout for the same package
  • new: auto completion class for IPython

• v0.4 - 2014/04/19

  • change: add the possibility to create more than one page of examples, use tag @example(page___title)
  • change: use method communicate in run_cmd <loghelper.flog.run_cmd>, remove characters \r on Windows
  • change: more robust function run_cmd <loghelper.flog.run_cmd>, change default values
  • change: synchronize_folder <sync.synchelper.synchronize_folder> now removes files when using a file to memorize the list of synchronized files
  • new: the documentation generation takes notebooks from folder _docs/notebooks