httpout
httpout is a runtime environment for Python files. It allows you to execute your Python scripts from a web URL, the print() output goes to your browser.
This is the classic way to deploy your scripts to the web.
You just need to put your regular .py files as well as other static files in the document root and each will be routable from the web. No server reload is required!
It provides a native experience for running your script from the web.
How does it work?
httpout will assign every route either like /hello.py or /index.py with the name __main__ and executes its corresponding file as a module in a thread pool.
Monkey patching is done at the module-level by hijacking the __import__.
In the submodules perspective, the __main__ object points to the main module such as /hello.py, rather than pointing to sys.modules['__main__'] or the web server itself.
httpout does not perform a cache mechanism like standard imports or with sys.modules to avoid conflicts with other modules / requests. Because each request must have its own namespace.
To keep it simple, only the main module is cached (as code object). The cache will be valid during HTTP Keep-Alive. So if you just change the script there is no need to reload the server process, just wait until the connection is lost.
Keep in mind this may not work for running complex python scripts, e.g. running other server processes or multithreaded applications as each route is not a real main thread.
Installation
python3 -m pip install --upgrade httpout
Example
# hello.py
import time
print('<pre>Hello...')
time.sleep(1)
print('and')
time.sleep(2)
print('Bye!</pre>')
Put hello.py in the examples/ folder, then run the httpout server with:
python3 -m httpout --port 8000 examples/
and your hello.py can be accessed at http://localhost:8000/hello.py.
If you don't want the .py suffix in the URL, you can instead create a hello/ folder with index.py inside.
Handling forms
This is an overview of how to view request methods and read form data.
# form.py
from httpout import wait, request, response
method_str = request.environ['REQUEST_METHOD']
method_bytes = request.method
if method_str != 'POST':
response.set_status(405, 'Method Not Allowed')
print('Method Not Allowed')
exit()
# we can't use await outside the async context
# so wait() is used here because request.form() is a coroutine object
form_data = wait(request.form())
print(method_str, method_bytes, form_data)
It can also be written this way:
# form.py
from httpout import run, request, response
method_str = request.environ['REQUEST_METHOD']
method_bytes = request.method
if method_str != 'POST':
response.set_status(405, 'Method Not Allowed')
print('Method Not Allowed')
exit()
async def main():
# using await instead of wait()
form_data = await request.form()
print(method_str, method_bytes, form_data)
run(main())
Then you can do:
curl -d foo=bar http://localhost:8000/form.py
Features
httpout is designed to be fun. It's not built for perfectionists. httpout has:
- A hybrid async and sync, the two worlds can coexist in your script seamlessly; It's not yet time to drop your favorite synchronous library
- More lightweight than running CGI scripts
- Your
print()s are sent immediately line by line without waiting for the script to finish like a typical CGI - No need for a templating engine, just do
if-elseandprint()making your script portable for both CLI and web - And more
Security
It's important to note that httpout only focuses on request security; to ensure that path traversal through the URL never happens.
httpout will never validate the script you write,
you can still access objects like os, eval(), open(), even traversal out of the document root.
So this stage is your responsibility.
FYI, PHP used to have something called Safe Mode, but it was deemed architecturally incorrect, so they removed it.
The PHP safe mode is an attempt to solve the shared-server security problem. It is architecturally incorrect to try to solve this problem at the PHP level, but since the alternatives at the web server and OS levels aren't very realistic, many people, especially ISP's, use safe mode for now.
License
MIT License
1 maintainer
Release files for httpout 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| httpout-0.1.1.tar.gz | 81.6 kB | Details |
Built distributions (wheels)
Total release size: 2.8 MB
Release files / httpout-0.1.1.tar.gz
| Download URL | httpout-0.1.1.tar.gz |
|---|---|
| Size | 81.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e949b7166a012fee82bc0dfc94b65b76bd806889fd92119ae1104d52e1e1b469
|
|
BLAKE2b-256 checksum How to use checksums |
264a8558bc111f6cd186794ded8702725877e667faea946a34e254b61a7608b9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-pp310-pypy310_pp73-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 42.7 kB |
| Tags | Linux glibc 2.17+ x86-64 Linux glibc 2.5+ x86-64 PyPy 3.10 PyPy 3.10 7.3 |
|
SHA-256 checksum How to use checksums |
c4e93baba41ddb82cc1f7a344e05f122626566ff3fbb461a22d8092f221d206f
|
|
BLAKE2b-256 checksum How to use checksums |
fb2a1a09227192378874036e239071bf64e4e5b5d2e2aba0b60dfc705953265a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 193.4 kB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
abf0c0574f097645cc0eac4ba6736e3b5be3a0be7aa0e1a4b52f66d2a5e5b979
|
|
BLAKE2b-256 checksum How to use checksums |
59877c2079a4e21ff9e2a901eb3266b61c871dfc9deb07f1389e012882a04203
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 195.7 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
6b770235f1c6eabfaa5123efe0fb1e292507a352b76d95560741f66ea3b9eedb
|
|
BLAKE2b-256 checksum How to use checksums |
4cc8b98ac4ff8cbd96610b464989e656bca393865769c94e428f1fb997e76148
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 208.5 kB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
02545c22580c2e1861c6d1fc7d899c92947ee4ca1b27831e58ec0c3f00f410d3
|
|
BLAKE2b-256 checksum How to use checksums |
509f376a30deaff375ed64cd1fd440269692e3e2f9c75a8dbe435b8e49926c0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 209.7 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
d5885eb1034796346f28289c770fc9fdb0557639a0cd8c4d4cbec5bca6b2ef30
|
|
BLAKE2b-256 checksum How to use checksums |
9177c53e1ef009e1fb73d9cc62c60182d738d5e4ef8504e9e7c8013a1b4c7de1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 203.0 kB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
c2772c539d0f190057a7925c5b9a3d8868ced9cff77ef37fbfadfc68bcef91ef
|
|
BLAKE2b-256 checksum How to use checksums |
d22bf89f53e9377e7a696993658302459751e595a14281281d955a98ee6fcbaa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 199.6 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
b0c328467e0b25fb70d30b9cc73d25414fc39587ec1ff8c756732cbebf1a33f2
|
|
BLAKE2b-256 checksum How to use checksums |
26443115dda9786bd1cc957de1bcabe263da19d8a7f20213e7ed57c194a2b633
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp310-cp310-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp310-cp310-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 191.6 kB |
| Tags | CPython 3.10 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
4220d3953df4b9ee798463a40d0ad9052184d8a4d95075e4549c28afbff41605
|
|
BLAKE2b-256 checksum How to use checksums |
05f208ef59ed0d5dfb80b78f880fac4245c6c0810618235b996727cb26b9aaab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 187.5 kB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
16c69a8732125dcf26d6ad1fefa6f62146ceb337caf26e19c3b45af0155b82d8
|
|
BLAKE2b-256 checksum How to use checksums |
e2eeea23cbd75876bb271a81f5cd73b3555eec56ea05390a0dfee6a32d4632aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp39-cp39-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp39-cp39-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 190.2 kB |
| Tags | CPython 3.9 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
8d16806bb0587ca15e0ef630cf1f0009684a16282280f6a99da36222bb8cb83f
|
|
BLAKE2b-256 checksum How to use checksums |
3e613fc3ea930f2462b7ce21d0ffe78a259099caa2ce714db0d5e18d0a65ded8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 185.2 kB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
a9d17afc212944e346448c23ccc59fe8880b5947fe60e93b99c384ee7deab9b2
|
|
BLAKE2b-256 checksum How to use checksums |
5778fb16b7160829ded0acd55f2da49f4cfc5a6d7232980f3e6ddfb8f74806f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp38-cp38-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp38-cp38-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 184.6 kB |
| Tags | CPython 3.8 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
9d9308184be3607f4193c523bc082d5740a2e1e762c08b4305f06db459450f11
|
|
BLAKE2b-256 checksum How to use checksums |
e97616259c407aead4b9b4e53ff99ab7536074ddb8be35c4f79791faf36ed7cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 181.5 kB |
| Tags | CPython 3.8 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
21a8e4b4b64b4bd6df703eadde55846df772e8b2dffbeb7c7deb6650620f2956
|
|
BLAKE2b-256 checksum How to use checksums |
3e0afe7fb3253b0261edeec36c0ac0bf26c5095156170d05365889cfe61469df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp37-cp37m-musllinux_1_2_x86_64.whl
| Download URL | httpout-0.1.1-cp37-cp37m-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 169.5 kB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
03269e726e13292b5bccf05d9af13d862f230f37e9935528c9cf52ea0305a013
|
|
BLAKE2b-256 checksum How to use checksums |
268324b9a3b7d6fa09c194bf6f93031475e844a3deab0702688c44c537eb0758
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency logRelease files / httpout-0.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | httpout-0.1.1-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 173.2 kB |
| Tags | CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
8379ce2a49d2df5327de551d122089bac71541ecaf9f84d2c461ed18bcc35ea7
|
|
BLAKE2b-256 checksum How to use checksums |
211b3a11d457e84f755ae17cfb5f8b76954303d3755f42522b59fe9ee74f09b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 7, 2025.
Transparency log
