pyquickhelper: automation of many things
pyquickhelper is used to automate the release of the documentation such as automating Jenkins, converting notebooks into many formats, extending Sphinx with custom extensions… It assumes the project is organized on the same template as this one.
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))
Links
1 maintainer
Metadata
1 maintainer
Release files for pyquickhelper 1.12.3823
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyquickhelper-1.12.3823.tar.gz | 3.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyquickhelper-1.12.3823-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 6.4 MB
Release files / pyquickhelper-1.12.3823.tar.gz
| Download URL | pyquickhelper-1.12.3823.tar.gz |
|---|---|
| Size | 3.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
db2bdf4f27542aa2097d3ce74908e8612b7ea2e40aa46b61863b293c33e9bc35
|
|
BLAKE2b-256 checksum How to use checksums |
b45e019b51cd63151d249e75b68b144a7153537a606d9dd9b93e9077aa9ec762
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.5
|
Release files / pyquickhelper-1.12.3823-py3-none-any.whl
| Download URL | pyquickhelper-1.12.3823-py3-none-any.whl |
|---|---|
| Size | 3.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a183c0c2202198387be79810396f282d07ecc2ecf77b95a17a3dbac12dd3c326
|
|
BLAKE2b-256 checksum How to use checksums |
3bff8ab2eb97c228b1877fc0a6317b20c6cc2bab5a166e70d500fff823c907a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.10.5
|
