backpipe 0.6.5

Description:

backpipe 0.6.5

Backpipe
Back-Ends simplified.







pip install backpipe

Info
Backpipe tries to support all operating systems.
But its primary focus lies on Linux support,
as it is the main choice for website hosting.

Running it on Windows might lead to issues and is not recommended.
Why the name?
The name 'Backpipe' is inspired by the english word 'Bagpipe'.
I decided to call it 'Backpipe', because it is a Back-End Framework.
It is just a little pun.
Samples
Hello World!
import backpipe

server = backpipe.BackPipe()

@server.get()
def hello_world(r: backpipe.Request):
return (200, "Hello World")

server.run()

What is my IP address?
import backpipe

server = backpipe.BackPipe()

@server.get()
def my_ip_address(r: backpipe.Request):
return (200, r.address)

server.run()

Complex Example
import backpipe

server = backpipe.BackPipe()

@server.any()
def wrong_method(r: backpipe.Request):
return (405, f"Wrong method: {r.method}, use POST.")

@server.unknown()
def unknown_method(r: backpipe.Request):
return (405, f"Unknown method: {r.method}, use POST.")

@server.post()
def login(r: backpipe.Request):
try:
if r.headers["key"] == "password1234":
return (200, "Password correct!")
else:
return (304, "Password wrong!")
except KeyError:
return (400, "invalid request, 'key' header missing.")

server.run()

Using Request Bodies
import backpipe

server = backpipe.BackPipe()

@server.post()
def respond(r: backpipe.Request):
return (200, r.body) # Returns the clients's request body

server.run()

Known issues

URI-too-long message raises error on client-side when using Python requests
Limited client information on URI-too-long message (probably unfixable.)

HTTPS notice
When activating HTTPS, you need to sign your certificate file
with a key provided by a trusted authority.

Self-signing your certificate will make tools such as
CURL, your Browser, etc. raise a warning,
that the website may be unsafe.
Documentation
Read through the Documentation,
to get started with backpipe
License
Backpipe is licensed under the GNU GPL v3.