PyPow! is the easy way to expose any cli command as a REST API.
PyPow is based in the original Kapow! Python code work of the original authors (see bellow).
What's this PyPow! by example
Oks, lets me explain what's is PyPow! with an example:
Imagine we have a bastion machine for our internal network, something similar like this diagram:
Problem we have
- We need to check that our database is alive
- We need to do that without login into any machine of the intranet.
- For us, it's enough to to ping the database machine for check that it's alive.
Solution using PyPow! / KaPow!
Write the ping.pow file like this:
kapow route add '/ping' - <<-'EOF' kapow set /response/headers/Content-Type text/plain nohup ping 10.10.10.1 >> /tmp/ping.txt & tail -f /tmp/ping.txt | kapow set /response/stream EOF
Launch service using Pypow! server:
$ kapow server ping.pow By default, PyPow listen port **8080**
Check your browser and freaks out :)
$ pip install pypow
PyPow! with Docker
$ docker run --rm pypow -h
PyPow! supports authentication by SSL client-server certificates.
Create CA (tl,dr)
Commands and examples borrowed from: https://tech-habit.info/posts/https-cert-based-auth-with-flask-and-gunicorn/
$ openssl req -nodes -new -x509 -days 365 -keyout ca.key -out ca-crt.pem
Create Pypow certificate
# create server private key and server CSR $ openssl req -nodes -new -keyout server.key -out server.csr # generate certicate based on server's CSR using CA root certificate and CA private key $ openssl x509 -req -days 365 -in server.csr -CA ca-crt.pem -CAkey ca.key -CAcreateserial -out server.crt # verify the certificate (optionally) $ openssl verify -CAfile ca-crt.pem server.crt
Create client certificate
# create client private key and client CSR $ openssl req -nodes -new -keyout client.key -out client.csr # generate certicate based on client's CSR using CA root certificate and CA private key $ openssl x509 -req -days 365 -in client.csr -CA ca-crt.pem -CAkey ca.key -CAcreateserial -out client.crt # verify the certificate (optionally) $ openssl verify -CAfile ca-crt.pem client.crt
Launching PyPow with certificates
See examples/ folder to check the samp:ping.pow file.
$ kapow server --capem ca-crt.pem --certfile server.crt --keyfile server.key --bind 127.0.0.1:9001 ping.pow
Connect to PyPow server with certificate
$ curl --insecure --cacert ca-crt.pem --key client.key --cert client.crt https://localhost:9001/ping
PyPow is a fork of the PoC of Kapow! whose authors are:
This repo is a fork that aims to maintain and extend the original Python implementation of Kapow!
PyPow is a Python implementation of Kapow! spec. It's based in the original Kapow! Python PoC.
This repo contains the Python implementation of Kapow! Spec:
if you're looking for high performance, then you need the official Go implementation of Kapow!