JustPy¶
Introduction¶
JustPy is an object-oriented, component based, high-level Python Web Framework that requires no front-end programming. With a few lines of only Python code, you can create interactive websites without any JavaScript programming. JustPy can also be used to create graphic user interfaces for Python programs.
Unlike other web frameworks, JustPy has no front-end/back-end distinction. All programming is done on the back-end allowing a simpler, more productive, and more Pythonic web development experience. JustPy removes the front-end/back-end distinction by intercepting the relevant events on the front-end and sending them to the back-end to be processed.
Note
The best way to understand JustPy is to follow thetutorial in which there are many examples.
In JustPy, elements on the web page are instances of component classes. A component in JustPy is a Python class that allows you to instantiate reusable custom elements whose functionality and design is encapsulated away from the rest of your code.
Custom components can be created using other components as building blocks. Out of the box, JustPy comes with support forHTML andSVG components as well as more complex components such ascharts andgrids. It also supports most of the components and the functionality of theQuasar library ofMaterial Design 2.0 components.
JustPy encourages creating your own components and reusing them in different projects (and, if applicable, sharing these components with others).
JustPy supports visualization usingmatplotlib andHighcharts.
JustPy integrates nicely withpandas and simplifies building web sites based on pandas analysis. JustPy comes with apandas extension that makes it simple to create interactive charts and grids from pandas data structures.
Hopefully, JustPy will enable teaching web development in introductory Python courses by reducing the complexity of web development.
Current Version of justpy¶
As of 2023-02-24 the current version of justpy is 0.12.2
If you have questions, suggestions or would like to get in touch¶
If you have a question about JustPy you are welcome to checkstackoverflow questions tagged justpy andEspecially questions which involve details of upstream frameworks such asag-grid,highcharts,pandas,plotly,quasar,tailwind and others are best ask involving the largerstackoverflow community and tagging your question with both "justpy" and the tag of the specific library your are asking a question for such as "ag-grid", "highcharts","quasar", "pandas"and others.
If you'd like to specifically address the JustPy contributors thegithub dicussions are place to ask questions,propose new features and generally get in touch with the contributors.
Our github dicussions are categorized. Please use the Category "Ideas" for feature requests.
Issues and pull requests are also welcome. Please make sure that you follow the stackoverflow style guidelines whenposting issues. A good way to do this is to state the problem as a stackoverflow question first. This way a larger audienceis able to discuss solutions and work arounds and find out which part of the technology stack you are using is actually involvedin the issue you'd like to get resolved.
If you followed the procedure you are welcome toopen an issue in theJustPy Github repository
Hello World! example¶
This is a simple hello world example for justpy.
importjustpyasjpdefhello_world_readme():wp=jp.WebPage()d=jp.Div(text='Hello world!')wp.add(d)returnwpjp.justpy(hello_world_readme)The program above activates a web server that returns a web page with 'Hello world!' for any request. Locally, you would direct your browser to http://127.0.0.1:8000 or http://localhost:8000/ to see the result.
Here is a slightly modified version in which 'Hello world!' changes to 'I was clicked!' when it is clicked.
Hello world with click¶
importjustpyasjpdefmy_click(self,msg):self.text='I was clicked!'defhello_world_readme2():wp=jp.WebPage()d=jp.Div(text='Hello world!')d.on('click',my_click)wp.add(d)returnwpjp.justpy(hello_world_readme2)Under the Hood¶
JustPy's backend is built using:
- starlette - "a lightweightASGI framework/toolkit, which is ideal for building high performance asyncio services".
- uvicorn - "a lightning-fastASGI server, built onuvloop andhttptools".
JustPy's frontend (which is transparent to JustPy developers) is built using:
- Vue.js - "The Progressive JavaScript Framework"
The way JustPy removes the frontend/backend distinction is by intercepting the relevant events on the frontend and sending them to the backend to be processed.
News and Updates¶
For news and updates please follow theJustPy Twitter account
License¶
Copyright (c) 2019-2022 Eliezer Mintz