A powerful and modern reporting tool for Python services.
Project description
Stimulsoft Reports.PYTHON
A powerful and modern reporting tool for Python services.
About the product
Stimulsoft Reports.PYTHON comprises a set of components for creating, viewing, exporting, and printing reports in applications and projects written in Python. The product supports connections of multiple data types, allowing you to work with reports on the server- and client-sides, and also offers extensive capabilities for data visualization and analysis.
Stimulsoft Reports.PYTHON is based on client-server technology: a Python application on the server-side and a JavaScript reporting engine on the client-side. These two parts are closely related and represent a single product that greatly simplifies working with reports in web applications written in Python.
Install reporting components
To install the Stimulsoft Reports.PYTHON, you can use the specified command:
python -m pip install stimulsoft-reports
Working with report generator
Report Engine
The StiReport component is designed to work with the report generator in a Web project. Using this component, you can create a report, load a report from a file or string, render a report, and call a report export function.
For simplicity, all code examples in this tutorial use the Flask framework (any other can be used).
The code example shows how you can load a report from a file, render it, and export it to HTML format:
app.py
from flask import Flask, render_template, url_for, request
from stimulsoft_reports.report import StiReport
from stimulsoft_reports.report.enums import StiExportFormat
app = Flask(__name__)
@app.route('/report', methods = ['GET', 'POST'])
def report():
report = StiReport()
if report.processRequest(request):
return report.getFrameworkResponse()
report.loadFile(url_for('static', filename='reports/SimpleList.mrt'))
report.render()
report.exportDocument(StiExportFormat.HTML)
js = report.javascript.getHtml()
html = report.getHtml()
return render_template('report.html', reportJavaScript = js, reportHtml = html)
report.html
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Render and Export a Report</title>
{{ reportJavaScript|safe }}
</head>
<body>
{{ reportHtml|safe }}
</body>
</html>
More details in our documentation.
Report Viewer
The StiViewer component is designed for viewing, printing and exporting reports in a browser window. The viewer can display it as a report template, as an already built report. Using this component, you can create a viewer object, set the necessary options, process the request and return the result of its execution, and receive the prepared JavaScript and HTML code of the component.
An example of displaying a viewer on an HTML page:
app.py
from flask import Flask, render_template, url_for, request
from stimulsoft_reports.viewer import StiViewer
app = Flask(__name__)
@app.route('/viewer', methods = ['GET', 'POST'])
def viewer():
viewer = StiViewer()
viewer.options.appearance.fullScreenMode = True
if viewer.processRequest(request):
return viewer.getFrameworkResponse()
report = StiReport()
report.loadFile(url_for('static', filename='reports/SimpleList.mrt'))
viewer.report = report
js = viewer.javascript.getHtml()
html = viewer.getHtml()
return render_template('viewer.html', viewerJavaScript = js, viewerHtml = html)
viewer.html
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Showing a Report in the Viewer</title>
{{ viewerJavaScript|safe }}
</head>
<body>
{{ viewerHtml|safe }}
</body>
</html>
There is a simplified deployment of the viewer without using an HTML page template. For example, this same example can be implemented using only Python code:
app.py
from flask import Flask, url_for, request
from stimulsoft_reports.viewer import StiViewer
app = Flask(__name__)
@app.route('/viewer', methods = ['GET', 'POST'])
def viewer():
viewer = StiViewer()
viewer.options.appearance.fullScreenMode = True
if viewer.processRequest(request):
return viewer.getFrameworkResponse()
report = StiReport()
report.loadFile(url_for('static', filename='reports/SimpleList.mrt'))
viewer.report = report
return viewer.getFrameworkResponse()
More details in our documentation.
Reports Designer
The StiDesigner component is designed for developing reports in a browser window. The designer's interface is built using HTML5, which allows it to be used on almost any modern platform and different operating systems. JavaScript technology used to build reports allows you to use almost any low-performance server side.
An example of displaying a designer on an HTML page:
app.py
from flask import Flask, render_template, url_for, request
from stimulsoft_reports.designer import StiDesigner
app = Flask(__name__)
@app.route('/designer', methods = ['GET', 'POST'])
def designer():
designer = StiDesigner()
designer.options.appearance.fullScreenMode = True
if designer.processRequest(request):
return designer.getFrameworkResponse()
report = StiReport()
report.loadFile(url_for('static', filename='reports/SimpleList.mrt'))
designer.report = report
js = designer.javascript.getHtml()
html = designer.getHtml()
return render_template(designer.html', designerJavaScript = js, designerHtml = html)
designer.html
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Editing a Report Template in the Designer</title>
{{ designerJavaScript|safe }}
</head>
<body>
{{ designerHtml|safe }}
</body>
</html>
There is a simplified deployment of the designer without using an HTML page template. For example, this same example can be implemented using only Python code:
app.py
from flask import Flask, url_for, request
from stimulsoft_reports.designer import StiDesigner
app = Flask(__name__)
@app.route('/designer', methods = ['GET', 'POST'])
def designer():
designer = StiDesigner()
designer.options.appearance.fullScreenMode = True
if designer.processRequest(request):
return designer.getFrameworkResponse()
report = StiReport()
report.loadFile(url_for('static', filename='reports/SimpleList.mrt'))
designer.report = report
return designer.getFrameworkResponse()
More details in our documentation.
Useful links
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for stimulsoft_reports-2024.2.4.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6d9d4099dfd507124b70002e72142af52f316a46f2fc8f540082b50df9f06075 |
|
| MD5 | bdf6a6c77e676d867b2b7ba16b8adc7e |
|
| BLAKE2b-256 | 8fcdf8a570eb3d3b1875cea6dfaccf1cf5006d9b233a8f3332e3f07967c842c2 |
Hashes for stimulsoft_reports-2024.2.4-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7a21855e4cc6b8efa7be64f0f998ea53a3698a37e0ad470b683a666b69643d8e |
|
| MD5 | 0aa5dc7dd9600702b5ebdd605c2a112c |
|
| BLAKE2b-256 | 8660373226b904cb7a73bfa444bc6ef8fab01a97e911f0f148f06c114afa9987 |
