PyWSGIRef 1.1.0

easy server-setup

PyWSGIRef

easy server-setup

Advantage

Many web services offer simple ways to set up a WSGI webserver.
The built-in WSGI server in Python is, however, not very easy to use.
PyWSGIRef provides a simple way to set up a WSGI server with minimal code.

Also, a problem with many of those web services is that they aren't able to make web requests
and it's very slow to read files once the server is running.
PyWSGIRef solves this problem by providing a simple way to load PyHTML files from the web or from the local filesystem
before the server is running.

PyHTML files are HTML files that can contain {}-s for Python formatting or
(upcoming) code blocks or shortened HTML, which can be used to create dynamic HTML content.
PyWSGIRef also provides a simple way to decode these.

Installation

Using pip

You can install PyWSGIRef via pip using

in a commandline:

py -m pip install PyWSGIRef

in a python script:

import os
os.system('py -m pip install PyWSGIRef')

Usage

Setting up the WSGI server

from PyWSGIRef import *

# Create a WSGI application object
def simple_app(path: str) -> str:
	return f"Hello, you visited {path}!"
application = makeWSGIApp(simple_app)

# Create a WSGI server
server = makeWSGIServer(application, port=8000)
server.serve_forever()

The makeWSGIApp function requires a callable that takes a single argument (the path) and returns a string response.
The makeWSGIServer function creates a WSGI server that listens on the specified port (default is 8000)
and calls the application object with the environ.
You may also specify advanced options in makeWSGIApp:

• you can set the advanced parameter to True, so that your application method also gets an FieldStorage type object
  
• you can set the setAdvancedHeaders parameter to True, so that the application method is also able to set status codes and types in the response headers,
  which is only possible if the advanced parameter is set to True
  Example:

from PyWSGIRef import *

# Create a WSGI application object with advanced options
def advanced_app(path: str, form: FieldStorage) -> str, str, str:
	# You can access form data here
	name = str(form.getvalue('name'))
	
	if path == "/hello":
		return f"Hello, {name}, you visited {path}!", "text/html", "200 OK"
	else:
		return "Page not found", "text/html", "404 Not Found"
application = makeWSGIApp(advanced_app, advanced=True, setAdvancedHeaders=True)

# Create a WSGI server
server = makeWSGIServer(application, port=8000)
server.serve_forever()

You can also use your own application object instead of the one created by makeWSGIApp.

Loading PyHTML

PyWSGIRef also provides a simple way to load PyHTML files:

from PyWSGIRef import *

# load from file
html = loadFromFile('index.pyhtml')

# load from web
html = loadFromWeb('https://example.com/index.pyhtml')

This is useful for serving dynamic HTML content in your WSGI application.
The funcs are callable unless you set up a server.

Using Templates

PyWSGIRef also provides a simple way to use templates in your WSGI application:

from PyWSGIRef import *

# add template to template dictionary
# -> saves as PyHTML object
addSchablone("index", loadedPyHTMLFile)

# load template from dictionary
# get HTML code from PyHTML object
html = SCHABLONEN["index"].decoded()
# use Python formatting
serverPageContent = html.format("Hello, World!")

Note that you may only use the addSchablone function before you set up a server.

Default HTML templates

PyWSGIRef comes with some default HTML templates that you can use in your WSGI application.
You can access them via the PyWSGIRef.defaults:

from PyWSGIRef import *

# load default HTML template
addSchablone("hello", HELLO_WORLD)
addSchablone("error", ERROR)

main script

You may produce a simple WSGI server by using either:

from PyWSGIRef import main

main()

or (from a commandline)

py -m PyWSGIRef

Decoding PyHTML

coming soon...

Others

Use the following to get information about your release and the author of the module:

from PyWSGIRef import about

about()

More coming soon