As a docker image !
pye is basically a "web editor" to dev "web things" (with python3) online. It's a ASGI thing, using uvloop+gunicorn. (it's between appJet and glitch.com .... focused on python3/async, see at the bottom)
Unittests(97%cov) + docs will come later
Using docker-hub image :
sudo docker run -p 8111:8080 -e PYEPASS=test -e PYEWORKERS=1 manatlan/pye
And go to http://localhost:8111/ed, enter "test"+RETURN, you are in the editor/admin place, and can do all what you want. But keep in mind, that everything you edit/create will disapear after stoping the instance.
sudo docker run -p <<YOUR_PORT>>:8080 -v <<YOUR_FILES_FOLDER>>:/app/files -e PYEPASS=<<YOUR_PASSWORD>> -e PYEWORKERS=<<YOUR_NB_OF_WORKERS>> manatlan/pye
If "YOUR_FILES_FOLDER" folder is empty, first run will fill it with defaults one (tutorial + edit'or + tests) In this case, all modifications will be in your filesystem. It's a lot better ;-)
Using the Dockerfile / github repo
./build
./run
And you can surf to :
- http://localhost:12345/
- http://localhost:12345/edit (with pass "test")
sudo docker run -p <<YOUR_PORT>>:8080 -v <<YOUR_FILES_FOLDER>>:/app/files -e PYEPASS=<<YOUR_PASSWORD>> -e PYEWORKERS=<<YOUR_NB_OF_WORKERS>> pye
./connect
A (web) PYthon Engine ... to developp websites in websites ;-)
Basically, it operates in the HTTP part, by handling HTTP requests. Between the client and the filesystem (or db). If the http request address a static file, pye will return the static file, if the http request adress a dynamic/python file, pye will return the execution of this dynamic file. That's all.
BUT ... with a special dynamic file, called "ed", the http response will be a full featured online editor, which will let the user edit its files online, thru a web browser (desktop or mobile). "ed" is just like any files, but you can access and edit your server, thru a simple web browser.
"ed" can be edited thru "ed", and be adapted to your needs ... but pye comes with many tricks, that handle a lot of things (admin access, import statement, path resolvers, 304 responses, concatenate files, post processing, 404 & 500 handlers, ...)
BTW, pye is designed to work on GoogleAppEngine 2nd Generation (python37), or any hosts that provides python3.
... to be continued ...