reportng
Version 1.0.0
Version 1.0.0 on is python 3 only, and is fully refactored and will not work with any versions prior to it.
reportng is a simple and opinionated python module that allows one to create beautiful yet simple Bootstrap 4 html reports. Reportng is capable of with any string type output that is generated by python. Use cases are building beautiful output from tools/scripts or just python in general
Currently, reportng supports the following:
- Search and highlight (supports regex) and hit count
- Self populating dropdown menu for report sections.
- Code sections with lexing
- Asciinema integration
- Image carousels with captions
- Stackable cards
- Social integrated footers
- Progress bar
- Tables
- List groups
The following decorators can also be added:
- modals
- reference buttons
- badges
Installation
pip install -U reportng
Documentation
Documentation is on readthedocs
Example
Main methods
-
section is used to create the main body/section for reportng. This method supports pre tags by default, but p can be used also.
- image_carousel is used to add an image carousel. It takes *args and multiple images can be passed to it.
-
asciinema is used to add an asciinema. At the moment, it can use take a valid asciinema url. Example
https://asciinema.org/a/117928
-
code is used to add code that is lexed and highlighted using highlight.js
- captions is used to add a simple p tag. Useful to add information below sections
-
cards is used to create stackable cards
-
table is used to create tables
-
footer is used to add an optional footer. The footer supports social icons like github, twitter etc along with custom messages.
- save is used to save the report to disk.
