pybloqs 1.1.3

Install PyBloqs

For a minimal install without HighCharts support run:

pip install pybloqs

or when installing in development mode:

python setup.py develop

This will allow you to run the example code below.

External dependencies

For full functionality, PyBloqs requires the following 3rd party programs and libraries. For some, the file location must be specified at install time:

pip install --install-option="INSTALL OPTIONS" git+https://github.com/manahl/pybloqs.git

e.g.

pip install --install-option="--highcharts=~/node_modules/highcharts/,~/node_modules/highcharts-heatmap/" git+https://github.com/manahl/pybloqs.git

• Libraries bundled with PyBloqs:

• jsinflate.js (https://github.com/augustl/js-inflate; MIT License)

• jquery.js (https://jquery.com; MIT License)

• jquery-DataTables.js (https://datatables.net; MIT License)

• wkhtmltopdf/wkhtmltoimage (http://wkhtmltopdf.org/; LGPLv3):

wkhtmltopdf is not bundled with PyBloqs. You need to install it from your distribution’s repository (Linux) or download it from the project page (https://wkhtmltopdf.org) . The binaries wkhtmltopdf and wkhtmltoimage are used for file output other than HTML. PyBloqs will search for the binaries on the system path. If you would like to use a local copy of the binaries, install with following option:

--wkhtmltopdf=/path/to/binary

When installing in development mode you can load highcharts explicitly:

python setup.py load_wkhtmltopdf --wkhtmltopdf=/path/to/binary

• HighCharts (optional; proprietery license, see https://shop.highsoft.com/highcharts-t2):

Highcharts is not bundled with PyBloqs. To create blocks with Highcharts plots, you need to download Highcharts separately (e.g. with npm install highcharts, npm install highcharts-heatmap etc.), and provide the path to your highcharts installation. Please make sure you have the right license for Highcharts. For full functionality you will need the following highcharts packages: highcharts, highcharts-heatmap, highcharts-funnel, highcharts-exporting, highcharts-export-csv (this example assumes, npm installed files into directory ~/node_modules).

--highcharts=~/node_modules/highcharts/,
~/node_modules/highcharts-heatmap/,~/node_modules/highcharts-funnel,~/node_modules/highcharts-exporting,
~/node_modules/highcharts-export-csv

When installing in development mode you can load highcharts explicitly (this example assumes, npm installed files into directory ~/node_modules)

python setup.py load_highcharts --highcharts=~/node_modules/highcharts/,~/node_modules/highcharts-heatmap/,\
~/node_modules/highcharts-funnel,~/node_modules/highcharts-exporting,~/node_modules/highcharts-export-csv

Using PyBloqs

from pybloqs import Block, HStack, VStack
import pandas as pd
from matplotlib import pyplot as plt

text_block = Block('This is a text block', styles={'text-align':'center', 'color':'blue'})
text_block.show()

df = pd.DataFrame([[1., 2.],[3.,4.]], columns =['a', 'b'])
table_block = Block(df)
table_block.show()

plot_block = Block(plt.plot(df['a'], df['b']))
plot_block.show()

plot_and_table = HStack([plot_block, table_block])
report = VStack([text_block, plot_and_table])
report.show()
report.save('report.pdf')

1.0.0 (2017-04-07)

• Initial public release

1.0.1 (2017-04-13)

• Integration with pypi and ReadTheDocs.

• Installation on Mac and Windows.

1.0.2 (2017-04-26)

• Metadata and badge for Python version.

• Python 3 compatibility changes, part 1.

• Installation with Coveralls.

1.0.3 (2017-04-26)

• Bugfix: Import of urlparse corrected, fixes Block.show() .

1.1.0 (2017-05-10)

• jQuery DataTables support.

• HTML anchors.

• Bugfix: Width of HTML-body no longer hard-coded.

1.1.1 (2017-05-10)

• Bugfix: Static data including DataTables CSS.

1.1.2 (2017-06-2)

• Bugfix: Image size for Matplotlib figure no longer truncated to whole number.

• Updated download path for wkhtmltopdf in CI setup.

1.1.3 (2017-06-6)

• Bugfix: Expansion of user home directory for show().

• Bugfix: Flexible definition of default type handling for Block() that allows updating.