Files
kapow/README.md
César Gallego Rodríguez d54beb3454 even more fixes
2019-06-20 12:02:08 +02:00

61 lines
1.9 KiB
Markdown

![Kapow!](https://trello-attachments.s3.amazonaws.com/5c6edee98297dc18aa4e2b63/960x720/ff8d28fc24af11e3295afa5a9665bdc0/kapow-1601675_960_720.png)
**Kapow!** If you can script it, you can HTTP it.
# CAVEAT EMPTOR
**Warning!!! Kapow!** is under heavy development and [specification](/spec/);
the provided code is a Proof of Concept and the final version will not even
share programming language. Ye be warned.
## How Kapow! was born
Some awesome history is coming.
# Kapow! for the impatient
When you need to share a command but not a whole
system, Kapow! will help you by the power of HTTP:
![Kapow! lives](https://trello-attachments.s3.amazonaws.com/5c824318411d973812cbef67/5ca1af818bc9b53e31696de3/784a183fba3f24872dd97ee28e765922/Kapow!.png)
Kapow! allows you to write a litte script that will serve an executable. This
script will let you define how to connect HTTP and the Shell using Kapow!'s
shell abstractions to the HTTP world. See it to believe:
![Kapow! in action](https://trello-attachments.s3.amazonaws.com/5c824318411d973812cbef67/5ca1af818bc9b53e31696de3/b5e2554ff02fd9dba5ed2cec5c5d41e1/hello_kapow.gif)
## Kapow! Superpowers
Kapow! gives you:
* A very simple way to turn any shell executable into an API
* A remote administration API
* A way to define the integration in you own terms, obligations-free!
## Kapow! Curses
Kapow! can't help when:
* You need high throughput: Kapow! spawns a new executable for every HTTP call
* You must perform complex logic to attend the request: never use Kapow! if
your executables don't perform al least 90% of the hard work
* You are building a huge application
## When Kapow! is your best ally:
* Easy command + Hard API = Kapow! to the rescue
* SSH for one command? Kapow! allows you to share only that command
* Remote instrumentation of several machines? make it easy with Kapow!
# Kapow! The more you know
If you want to know more, please follow our [documentation](/doc).