The Piper networking protocol in Python.
The version on pypi is the stable version, and the version on github is the development version.
To get it from pypi use:
pip3 install pyper-piper
To install from github use:
pip3 install git+https://github.com/Bigjango13/Pyper
If you are making you're own changes to pyper it can be installed with
pip3 install path/to/pyper
An example server and an example client can be found under the examples directory.
The piper specification version that pyper is currently based on can be accesesed throught the piperSpecVersion
variables.
These content types can be used instead of the ids for content types, here they are:
utf8
(00)
gemtext
(01)
ascii
(02)
file
(10)
redirect
(20)
notFound
(22)
internalError
(23)
specVersion
(24)
There are also some content types from libpiper for compatibility.
clientOutOfMemory
(F0)
clientConnectionError
(F1)
clientInternalError
(F2)
There is also one I added to handle invaid data sent from the server.
clientInvalidData
(F3)
There is also a dictonary that can be used to translate the content types into more human friendly variants, it is called contentType
.
The pyperDebug
variable will toggle printing the packets, it defaults to whatever PYPER_DEBUG
is set to (None in most cases) but can be changed in python.
Takes the current url, the current port, and the url that the current url is telling you to redirect to.
Gets the url to redirect to and returns the arguments for pyper.client.connect
.
Return the formated url.
Returns the arguments for pyper.client.connect
(excluding redirectsAllowed
) from a piper url.
Connects to a piper server based on the ip, port, path, and options.
If redirectsAllowed
is not equal to zero it will also automatically follow redirects and remove one from redirectsAllowed
, if it is set below zero it will always redirect.
Creates a pyper server and binds it to the ip and port.
Starts the server.
Meant to be used as a decorator, it maps a function to a path.
For example:
import pyper
pyperServer = pyper.server.PyperServer()
@pyperServer.parseRequest("/")
def index(request):
return pyper.common.ascii, "This is the index"
pyperServer.start()
if the option is "*" pyper will use it as a fallback for when a page isn't found (good for making a custom 0x22 page).
request
is dictionary that includes client_addr
(the address of the client), options
(a dictionary of the url options), and path
(the url path).