https://github.com/man-group/pybloqs
A flexible framework for visualizing data and automated creation of "good enough" reports.
https://github.com/man-group/pybloqs
email html pandas pdf python reports
Last synced: about 1 month ago
JSON representation
A flexible framework for visualizing data and automated creation of "good enough" reports.
- Host: GitHub
- URL: https://github.com/man-group/pybloqs
- Owner: man-group
- License: lgpl-2.1
- Created: 2016-07-04T14:05:10.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-08-27T10:56:29.000Z (about 1 month ago)
- Last Synced: 2025-08-27T18:57:08.015Z (about 1 month ago)
- Topics: email, html, pandas, pdf, python, reports
- Language: Python
- Homepage: https://pybloqs.readthedocs.io/
- Size: 11.6 MB
- Stars: 176
- Watchers: 25
- Forks: 46
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README

_PyBloqs is a flexible framework for visualizing data and automated creation of "good enough" reports._
[](https://circleci.com/gh/man-group/PyBloqs)
[](https://pypi.python.org/pypi/pybloqs/)
[](https://pybloqs.readthedocs.io)
[](https://coveralls.io/github/manahl/PyBloqs?branch=master)

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](http://pandas.pydata.org), [matplotlib](http://matplotlib.org) and
[highcharts](http://www.highcharts.com) 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](https://pybloqs.readthedocs.io/en/latest/installation.html) for further installation instructions.
### Using PyBloqs
Please consult the [user guide](https://pybloqs.readthedocs.io/en/latest/user_guide.html) for more in-depth usage.
```python
from pybloqs import Block, HStack, VStack
import pandas as pd
from matplotlib import pyplot as plttext_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](https://pybloqs.readthedocs.io/en/latest/configuration.html) section of the documentation for more details.
## Requirements
Please see [`pyproject.toml`](https://github.com/man-group/PyBloqs/blob/master/pyproject.toml) for a list of dependencies, and the [installation guide](https://pybloqs.readthedocs.io/en/latest/installation.html) for details on optional dependencies.
## Acknowledgements
PyBloqs has been under active development at [Man AHL](http://www.ahl.com/) since 2013.
### Original concept and implementation:
[](https://github.com/SleepingPills)
### Contributors:
[](https://github.com/DominikMChrist)
[](https://github.com/pablojim)
[](https://github.com/wilfred)
[](https://github.com/jamesmunro)
[](https://github.com/cozmacib)
[](https://github.com/swedishhh)
[](https://github.com/jjbmatthews)
[](https://github.com/rhodrich)
[](https://github.com/douglasbruce88)
[](https://github.com/jonnynye)
[](https://github.com/jjbmatthews)
[](https://github.com/HanTeo)
[](https://github.com/manjugoudreddy)
[](https://github.com/edf825)
[](https://github.com/jamesoliverh)
[](https://github.com/morotti)
[](https://github.com/rspencer01)
[](https://github.com/randra99)
[](https://github.com/jhylands)
[](https://github.com/skristof)
[](https://github.com/sjw61)
[](https://github.com/qiuyan-ge)
and many others at [Man Group](https://www.man.com/) and elsewhere...**Contributions welcome!**
## License
PyBloqs is licensed under the GNU LGPL v2.1. A copy of which is included in [LICENSE](https://github.com/man-group/PyBloqs/raw/master/LICENSE).