Create modern cross-platform apps in Python using HTML and CSS
Project description
Neutron allows developers to build native Python apps along with CSS and HTML for frontend design. Based on pywebview for it's native GUI window and JavaScript-Python communication.
- You can easily get started contributing by reading CONTRIBUTING.md
Installation
pip install Neutron-Web
Note: use
import Neutron
import Neutron-Web<-- WRONG
Building to EXE/APP/ELF
Note: This has only been tested on windows.
To build a Neutron project you first need pyinstaller, install pyinstaller throught pip: pip install pyinstaller. Then run the script below in your command prompt/terminal.
pyinstaller YOUR_PYTHON_FILE.py --noconsole --onefile --add-data="YOUR_HTML_FILE.html;." --add-data="YOUR_CSS_FILE.css;." --hidden-import pywebview --hidden-import beautifulsoup4 --hidden-import keyboard
Examples
For a fully set up example project see TEMPLATE. The project is build how it's intended, meaning it has a CSS and HTML file for the design and a Python file for the logic. (It is comparable to how websites using JavaScript are built).
Other examples
Althought not recommended for big projects, it's possible to create an app using only Python.
import Neutron
win = Neutron.Window("Example", css="def.css")
HeaderObject = Neutron.elements.Header(win, id="title", content="Hello")
def setName():
HeaderObject.setAttribute("style", "color: red;")
HeaderObject.innerHTML = "Hello world!"
win.getElementById("submit").innerHTML = "clicked!"
Neutron.elements.Button(win, id="submit", content="Hi", onclick=Neutron.event(setName))
win.show()
Another example featuring in-python HTML:
import Neutron
win = Neutron.Window("Example")
def setName():
name = win.getElementById("inputName").value
win.getElementById("title").innerHTML = "Hello: " + name
win.display(f"""
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
</head>
<body>
<h1 id="title">Hello: </h1>
<input id="inputName">
<button id="submitName" onclick="{Neutron.event(setName)}">Submit</button>
<!-- OR-->
{Neutron.Button(win, content="Submit", onclick=Neutron.event(setName))}
</body>
</html>
""")
win.show()
To resolve the loading time issue, Neutron features a loader system seen here:
import Neutron
win = Neutron.Window("Example", size=(600,100))
# The loader covers while all the other elements and css loads
win.loader(content="<h1>Loading App...</h1>", color="#fff", after=lambda: win.toggle_fullscreen())
def setName():
name = win.getElementById("inputName").value
win.getElementById("title").innerHTML = "Hello: " + name
win.display(f"""
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
</head>
<body>
<h1 id="title">Hello: </h1>
<input id="inputName">
<button id="submitName" onclick="{Neutron.event(setName)}">Submit</button>
<!-- OR-->
{Neutron.Button(win, content="Submit", onclick=Neutron.event(setName))}
</body>
</html>
""")
win.show()
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for Neutron_Web-0.1.1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b12e08e387169a8f3d9ba7a9851f7b1ed86dc712f7c54bbd90416143cb9e769e |
|
| MD5 | bd5e0f379f1df32af159707f362196b6 |
|
| BLAKE2b-256 | 511e8467a70426d2f6fb16baeee612d8dc2f9ba1abaf6a076caecf9884b4f8f8 |
