PyBloqs is a flexible framework for visualizing data and automated creation of "good enough" reports.
Sometimes all you want is a quick and easy way to generate a static report. No bells, no whistles, no server setup and no network permissions. Just a PDF, html file or even a PNG.
PyBloqs is the simple solution for creating such data-rich reports.
It works with Pandas, matplotlib and highcharts and more. See your blocks in a notebook, in the browser, or as an image, and easily share them via the filesystem or email!
PyBloqs creates atomic blocks containing text, tables (from data frames), plots (matplotlib, plotly or highcharts) or images. All blocks can be styled with CSS. Each block can be created and displayed separately for fast development turnover. Lists of blocks can be stacked together to form reports. Reports can be displayed as HTML in the browser or exported in a variety of formats (including HTML, PDF, SVG, PNG).
Quickstart
Install PyBloqs
$ pip install pybloqs
See the documentation for further installation instructions.
Using PyBloqs
Please consult the user guide for more in-depth usage.
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')
Configuration
You can specify per-user default parameters in a yaml-formatted file ~/.pybloqs.cfg. See the configuration section of the documentation for more details.
Requirements
Please see pyproject.toml for a list of dependencies, and the installation guide for details on optional dependencies.
Acknowledgements
PyBloqs has been under active development at Man AHL since 2013.
Original concept and implementation:
Contributors:
Contributions welcome!
License
PyBloqs is licensed under the GNU LGPL v2.1. A copy of which is included in LICENSE.
Release files for pybloqs 1.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pybloqs-1.4.3.tar.gz | 452.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pybloqs-1.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 654.4 kB
Release files / pybloqs-1.4.3.tar.gz
| Download URL | pybloqs-1.4.3.tar.gz |
|---|---|
| Size | 452.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e711ba5d73e5c2930ea3fe37b5f4270c07063d0c9105e0f1afec9db5ca37ee81
|
|
BLAKE2b-256 checksum How to use checksums |
d72794b19fd9fae1b4fe7e83b89174b29dc49ac5594f6377f25dc7ed725c3ace
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.0
|
Release files / pybloqs-1.4.3-py3-none-any.whl
| Download URL | pybloqs-1.4.3-py3-none-any.whl |
|---|---|
| Size | 202.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
39c106081548bc89dcc212a91922b63f0e56e0ef25f79c3583aa2557644c27b0
|
|
BLAKE2b-256 checksum How to use checksums |
b896a759fc29378bf797bf67c2e494805d91ebd0486a51d63a0323059302acb8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.0
|
