skip to navigation
skip to content

pyquickhelper 1.5.2234

Various functionalities: folder synchronization, a logging function, helpers to generate documentation with sphinx, generation of code for Python 2.7 from Python 3

Package Documentation

README

Links:

Functionalities

  • simple forms in notebooks
  • help generation including notebook conversion
  • folder synchronization
  • logging
  • help running unit tests
  • simple server to server sphinx documentation
  • file compression, zip, gzip, 7z
  • helpers for ipython notebooks (upgrade, offline run)
  • parser to quickly add a magic command in a notebook
  • Sphinx directives to integrate a blogpost in the documentation
  • mechanism to add forms in notebooks

Design

This project contains the following folders:

  • a source folder: src
  • a unit test folder: _unittests, go to this folder and run run_unittests.py
  • a folder: _doc, it will contain the documentation, a subfolder _doc/sphinxdox/source/blog contains blog post to communicate on the module
  • a file setup.py to build and to install the module, if the source were retrieve from GitHub, the script can also be called with the following extra options (python setup.py <option>): * clean_space: remove extra spaces in the code * build_sphinx: builds the documentation * unittests: run the unit tests, compute the code coverage
  • a script build_script.bat which produces many script on Windows to easily run the setup, generate the documentation, run the unit tests.

Examples

Convert a notebook into slides:

from pyquickhelper.helpgen import nb2slides
nb2slides("nb.ipynb", "convert.slides.html")

Merge two notebooks:

from pyquickhelper.ipythonhelper import read_nb
nb1 = read_nb("<file1>", kernel=False)
nb2 = read_nb("<file2>", kernel=False)
nb1.merge_notebook(nb2)
nb1.to_json(outfile)

Run a notebook:

from pyquickhelper.ipythonhelper import run_notebook
run_notebook("source.ipynb", working_dir="temp",
            outfilename="modified.ipynb",
            additional_path = [ "c:/temp/mymodule/src" ] )

Run a command line program:

from pyquickhelper.loghelper import run_cmd
out,err = run_cmd("python setup.py install", wait=True)

A sphinx extension to generate python documentation from a script:

.. runpython::
    :showcode:

    import sys
    print("sys.version_info=", str(sys.version_info))

History

1.5.???? (2017-??-??)

Bugfix

  • 46: update to Sphinx 1.6
  • 54: fix searchbox for sphinx_rtd_theme
  • 69: overwrites toctree to catch exception and process rst inline
  • 71: skip old notebook execution when computing the coverage

Features

  • 56: support function for role epkg
  • 36: add support for sphinx-gallery
  • 53: handle history, converts the file into something usable by module releases
  • 52: add coverage for notebooks
  • 61: add a build on circleci, builds the documentation, populates the artifacts section
  • 63: add file_detail in get_repo_log
  • 60: add notebook coverage as a separate page
  • 34: applies pep8 on the code being rendered on the documentation
  • 65: add function to clean readme.rst before sending it to pypi
  • 67: add toctree delayed which gets filled after the dynamic content is created, use it for blogs
  • 77: add class ExtUnitCase with extensive test function
  • 78: get_temp_folder change other default directory
  • 81: add youtube sphinx extension
 
File Type Py Version Uploaded on Size
pyquickhelper-1.5.2234-py3-none-any.whl (md5) Python Wheel 3.6 2017-10-19 505KB
pyquickhelper-1.5.2234.tar.gz (md5) Source 2017-10-19 2MB