Files
kapow/README.md
2019-06-20 11:06:06 +02:00

59 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 develepment 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 connect HTTP to 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
* Opinion free shell integration
## Kapow! Curses
Kapow! can't help when:
* You need high throughput: Kapow! spawn a new executable every HTTP call
* You must perform complex logic to attend the request: never use Kapow! if
your executables doesn'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! allow 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).