https://github.com/ahmadnassri/parakeet
Echo server for TCP/UDP/HTTP
https://github.com/ahmadnassri/parakeet
cli
Last synced: 9 months ago
JSON representation
Echo server for TCP/UDP/HTTP
- Host: GitHub
- URL: https://github.com/ahmadnassri/parakeet
- Owner: ahmadnassri
- License: mit
- Created: 2016-02-26T04:46:31.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-03-04T02:48:51.000Z (over 7 years ago)
- Last Synced: 2025-02-26T20:23:15.107Z (over 1 year ago)
- Topics: cli
- Language: JavaScript
- Homepage:
- Size: 185 KB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Parakeet
[![License][license-image]][license-url] [![version][npm-image]][npm-url] [![Build Status][circle-image]][circle-url]
> Echo server for TCP/UDP/HTTP
Watch the screencast [here](https://asciinema.org/a/37456)
## About
> The common parakeet (Melopsittacus undulatus), is a popular talking-bird species because of their potential for large vocabularies, ease of care and well-socialized demeanor.
> [https://en.wikipedia.org/wiki/Parakeet](https://en.wikipedia.org/wiki/Parakeet)
## Message Format
| event | format | example |
| ---------------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
| server start | `[TIME] ▶️ TYPE LISTEN_IP LISTEN_PORT` | `[03:32:54 AM] ▶️ TCP 127.0.0.1 1338` |
| connection open | `[TIME] ⚪ REMOTE_IP REMOTE_PORT` | `[03:32:54 AM] ⚪️ TCP 127.0.1.1 1338` |
| connection close | `[TIME] ⚫️️ REMOTE_IP REMOTE_PORT` | `[03:32:54 AM] ⚫️️️ TCP 127.0.1.1 1338` |
| data recieved | `[TIME] ✔ REMOTE_IP REMOTE_PORT [BYTES] "MESSAGE"` | `[03:33:00 AM] ✔ (127.0.0.1 57619) [8] "hello!\r\n"` |
| http signature _(http only)_ | `[TIME] ✔ REMOTE_IP REMOTE_PORT HTTP_VERSION METHOD URL` | `[03:32:33 AM] ✔ (127.0.0.1 49575) HTTP/1.1 POST /` |
| http headers _(http only)_ | `[TIME] ✔ REMOTE_IP REMOTE_PORT KEY: VALUE` | `[03:32:33 AM] ✔ (127.0.0.1 49575) Host: localhost:8080` |
## Sample Output
###### TCP
```plain
[03:32:54 AM] ▶️ TCP 127.0.0.1 1338
[03:32:57 AM] ⚪ (127.0.0.1 57619)
[03:33:00 AM] ✔ (127.0.0.1 57619) [8] "hello!\r\n"
[03:33:08 AM] ⚫️️️ (127.0.0.1 57619)
```
###### UDP
```plain
[03:32:41 AM] ▶️ UDP4 127.0.0.1 1337
[03:32:45 AM] ✔ (127.0.0.1 45464) [6] "hello\n"
[03:32:46 AM] ✔ (127.0.0.1 45464) [6] "world\n"
```
###### HTTP
```plain
[03:32:27 AM] ▶️ HTTP 127.0.0.1 8080
[03:32:31 AM] ⚪ (127.0.0.1 49574)
[03:32:31 AM] ✔ (127.0.0.1 49574) HTTP/1.1 POST /
[03:32:31 AM] ✔ (127.0.0.1 49574) Host: localhost:8080 Content-Length: 36 Content-Type: application/json; charset=utf-8 Accept-Encoding: gzip, deflate, compress Accept: application/json User-Agent: HTTPie/0.8.0
[03:32:31 AM] ✔ (127.0.0.1 49574) [36] {"name": "ahmad", "city": "toronto"}
[03:32:31 AM] ⚫️️️ (127.0.0.1 49574)
[03:32:33 AM] ⚪ (127.0.0.1 49575)
[03:32:33 AM] ✔ (127.0.0.1 49575) HTTP/1.1 POST /
[03:32:33 AM] ✔ (127.0.0.1 49575) Host: localhost:8080 Content-Length: 23 Content-Type: application/x-www-form-urlencoded; charset=utf-8 Accept-Encoding: gzip, deflate, compress Accept: */* User-Agent: HTTPie/0.8.0
[03:32:33 AM] ✔ (127.0.0.1 49575) [23] name=ahmad&city=toronto
[03:32:33 AM] ⚫️️️ (127.0.0.1 49575)
```
## Install
```bash
npm install parakeet
```
## Usage
```plain
Usage: parakeet [options] [command]
Commands:
http start HTTP echo server
tcp start TCP echo server
udp start UDP echo server
Options:
-h, --help output usage information
-V, --version output the version number
-p, --port port to listen on
-a, --address
network address to listen on
```
---
> Author: [Ahmad Nassri](https://www.ahmadnassri.com/) •
> Github: [@ahmadnassri](https://github.com/ahmadnassri) •
> Twitter: [@AhmadNassri](https://twitter.com/AhmadNassri)
[license-url]: LICENSE
[license-image]: https://img.shields.io/github/license/ahmadnassri/parakeet.svg?style=for-the-badge&logo=circleci
[circle-url]: https://circleci.com/gh/ahmadnassri/workflows/parakeet
[circle-image]: https://img.shields.io/circleci/project/github/ahmadnassri/parakeet/master.svg?style=for-the-badge&logo=circleci
[npm-url]: https://www.npmjs.com/package/parakeet
[npm-image]: https://img.shields.io/npm/v/parakeet.svg?style=for-the-badge&logo=npm