A simple way to create rich interactive websites and dashboards compatible with modern web frameworks
This project is in active and constant improvement so do not forget to run the below command to always get the latest version install.
pip install epyk --upgrade
We started the implementation of Epyk already few years ago in order to help Python developers (from beginner to advanced) to present their work to clients or colleagues. At this time there were only few packages in Python available and it was quite difficult for people to move to web technologies like JS, HTML and CSS.
With this idea we started to create Epyk, a kind of transpiler which is dedicated to assist from Python the developers to develop rich web UI. It will try, thanks to the autocompletion provided by the library, to familiarise the developer / data scientist in the wording of web technologies. Indeed we tried as much as possible to keep the same naming convention for CSS attributes and Javascript function to simplify the review of the transpiled HTML page if needed.
Today Epyk is a bit more than a transpiler as it will encompass more than 100 JavaScript and CSS modules.
Most of the popular web libraries (JQuery, Bootstrap, ApexCharts, ChartJs, Tabulator, AgGrid...) are available from the Epyk components. The resulting page transpiled will only import the ones needed for the selected components.
For people impatient to understand the concept, you can test the below minimalist dashboard.
Install Epyk
pip install epyk
The below code will create a simple interactive dashboard relying on internal mock data.
import epyk as pk
# Just to get mock data to test
from epyk.mocks import randoms
page = pk.Page()
page.headers.dev()
js_data = page.data.js.record(data=randoms.languages)
filter1 = js_data.filterGroup("filter1")
select = page.ui.select([
{"value": '', 'name': 'name'},
{"value": 'type', 'name': 'code'},
])
bar = page.ui.charts.chartJs.bar(randoms.languages, y_columns=["rating", 'change'], x_axis='name')
pie = page.ui.charts.chartJs.pie(randoms.languages, y_columns=['change'], x_axis='name')
page.ui.row([bar, pie])
select.change([
bar.build(filter1.group().sumBy(['rating', 'change'], select.dom.content, 'name')),
pie.build(filter1.group().sumBy(['change'], select.dom.content, 'name')),
])
More information in the doc Getting started with Epyk
First install Epyk to your Python environment
pip install epyk
Create a report and change CSS3 or add JavaScript events.
import epyk as pk
page = pk.Page()
page.headers.dev()
button = page.ui.button("Click me")
button.style.css.color = "red"
button.click([
page.js.console.log("log message")
])
....
# Then to produce the html page
page.outs.html_file(path="/templates", name="test")
Go to the next level and add real time flux in few lines or code. Epyk allows to integrate concepts of Reactive programming thanks to Python 3 and asyncio. All the features available in JavaScript (socket, websocket, observable ...) can be used as long as the underlying webserver is compatible.
If the underlying web server is not compatible with those modern features, Ajax (post, get...) are also available. More examples are available in the []template / interactive](https://github.com/epykure/epyk-templates/tree/master/interactives) section.
On the client side
import epyk as pk
page = pk.Page()
page.headers.dev()
socket.connect(url="127.0.0.1", port=3000, namespace="/news")
input = page.ui.input()
pie = page.ui.charts.chartJs.polar([], y_columns=[1], x_axis="x")
container.subscribe(socket, 'news received', data=socket.message['content'])
pie.subscribe(socket, 'news received', data=socket.message['pie'])
page.ui.button("Send").click([
socket.emit("new news", input.dom.content)
])
page.outs.html_file(path="/templates", name="socket_example")
On the server side (using socketio)
from flask import Flask, render_template_string
from flask_socketio import SocketIO, emit
app = Flask(__name__)
app.config['SECRET_KEY'] = 'secret!'
socketio = SocketIO(app)
@socketio.on('new news', namespace='/news')
def new_news(message):
values = getSeries(5, 100)
result_pie = chart_data.chartJs.y(values, [1, 4, 5], 'g')
emit('news received', {"content": message, 'pie': result_pie}, broadcast=True)
We maintain a separate Github repository of Jupyter Notebooks that contain an interactive tutorial and examples:
https://nbviewer.jupyter.org/github/epykure/epyk-templates-notebooks/
To launch a live notebook server with those notebook using binder click on one of the following badge:
More examples are available on the official repository
No dependency hence the library can be integrated to any existing Python project
Epyk is compatible with the most common Web Python Frameworks (Flask and Django). By default, the server package embeds a Flask app as it is easier to install and ready to use.
The Framework can be included within a Jupyter or JupyterLab project. But this will lead to some limitations - for example Ajax and Socket will not be available.
The generated Web pages are compatible with the common modern web frameworks.
Epyk Studio is a rich and collaborative framework to simplify the use of this library with bespoke configuration / styles. You can start downloading it here or contribute to the project on the Github repository. This is still under development hence it is not yet official released
See CONTRIBUTING.md
Please get in touch if there is any feature you feel Epyk-UI needs.
Want to donate? Feel free. Send to blockchain
FAQs
A simple way to create rich interactive websites and dashboards compatible with modern web frameworks
We found that epyk demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.