https://github.com/zhaojh329/evmongoose

DEPRECATED. Evmongoose is an asynchronous, event(libev) based multi-protocol embedded networking library with functions including TCP, HTTP, WebSocket, MQTT and much more. It's based on mongoose and libev implementation and it's support Lua API.
https://github.com/zhaojh329/evmongoose

async cgi dns-resolver event evhttp evmongoose evmqtt http https lede libev lua-http lua-mqtt lua-server lua-web mongoose mqtt openwrt server web

Last synced: 3 days ago
JSON representation

DEPRECATED. Evmongoose is an asynchronous, event(libev) based multi-protocol embedded networking library with functions including TCP, HTTP, WebSocket, MQTT and much more. It's based on mongoose and libev implementation and it's support Lua API.

• Host: GitHub
• URL: https://github.com/zhaojh329/evmongoose
• Owner: zhaojh329
• License: gpl-3.0
• Created: 2017-05-25T14:44:22.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-01-14T04:08:43.000Z (almost 7 years ago)
• Last Synced: 2024-12-10T16:25:27.767Z (12 days ago)
• Topics: async, cgi, dns-resolver, event, evhttp, evmongoose, evmqtt, http, https, lede, libev, lua-http, lua-mqtt, lua-server, lua-web, mongoose, mqtt, openwrt, server, web
• Language: C
• Homepage:
• Size: 1020 KB
• Stars: 213
• Watchers: 16
• Forks: 55
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: contributing.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[libuhttpd]: https://github.com/zhaojh329/libuhttpd

[libuwsc]: https://github.com/zhaojh329/libuwsc

[libumqttc]: https://github.com/zhaojh329/libumqttc

# DEPRECATED.  Replaced by [libuhttpd], [libuwsc], [libumqttc] 

# Evmongoose([中文](https://github.com/zhaojh329/evmongoose/blob/master/README_ZH.md))([github](https://github.com/zhaojh329/evmongoose))

![](https://img.shields.io/badge/license-GPLV3-brightgreen.svg?style=plastic "License")

![](https://github.com/zhaojh329/image/blob/master/evmongoose.png)

Evmongoose is an asynchronous, event(libev) based multi-protocol embedded networking library 

with functions including TCP, HTTP, WebSocket, MQTT and much more. It is based on [mongoose](https://github.com/cesanta/mongoose)

and [libev](https://github.com/kindy/libev) implementation and it's support Lua API.

Evmongoose supports highly customized to extend your application. Before I started this project, I had never found a HTTP server

library that was satisfied with the event based framework, and those HTTP server libraries could only loop it'sown objects and 

could not add my own objects. For example, I want to monitor a signal or a file through the event.

# Features

* New from evmongoose

    - Using libev programming 

	- Highly customized to extend your application based on libev

	- Lua API(except wrapper for evmongoose and additional include frequently-used posix C API)

* Inherited from mongoose

	- plain TCP, plain UDP, SSL/TLS (over TCP, one-way or two-way)

	- Alternative openssl and mbedtls

	- HTTP client, HTTP server

	- HTTP File Upload

	- Proxy

	- WebSocket client, WebSocket server

	- MQTT client, MQTT broker

	- CoAP client, CoAP server

	- DNS client, DNS server, async DNS resolver

	- Url Rewrite

# [Example](https://github.com/zhaojh329/evmongoose/blob/master/example)

* [simplest web](https://github.com/zhaojh329/evmongoose/blob/master/example/simplest_web.c)

* [simplest web on ssl](https://github.com/zhaojh329/evmongoose/blob/master/example/simplest_web_ssl.c)

* [http client](https://github.com/zhaojh329/evmongoose/blob/master/example/http_client.c)

* [async DNS resolver](https://github.com/zhaojh329/evmongoose/blob/master/example/async_dns_resolver.c)

* [Lua](https://github.com/zhaojh329/evmongoose/blob/master/example/lua)

# How To Compile

## For Ubuntu

### Install dependency Libraries

* libev-dev libssl-dev lua5.1 liblua5.1-0-dev lua-zlib

		sudo apt install libev-dev libssl-dev lua5.1 liblua5.1-0-dev lua-zlib

* lua-ev

		git clone https://github.com/brimworks/lua-ev.git

		cd lua-ev

		cmake . -DINSTALL_CMOD=$(lua -e "for k in string.gmatch(package.cpath .. \";\", \"([^;]+)/..so;\") do if k:sub(1,1) == \"/\" then print(k) break end end")

		make && sudo make install

    

### Install Evmongoose(HTTPS Support Default)

    git clone https://github.com/zhaojh329/evmongoose.git

    cd evmongoose

    mkdir build

    cd build

    cmake ../

    make && sudo make install

### Install Evmongoose(Disable HTTPS Support)

    git clone https://github.com/zhaojh329/evmongoose.git

    cd evmongoose

    mkdir build

    cd build

    cmake ../ -DHTTPS_SUPPORT=OFF

    make && sudo make install

## For OpenWRT/LEDE

	git clone https://github.com/zhaojh329/lua-ev-openwrt.git

	cp -r lua-ev-openwrt openwrt_dir/package/lua-ev

	

	git clone https://github.com/zhaojh329/evmongoose.git

	cp -r evmongoose/openwrt openwrt_dir/package/evmongoose

	

	cd openwrt_dir

	./scripts/feeds update -a

	./scripts/feeds install -a

	

	make menuconfig

	Libraries  --->

	    Networking  --->

	        <*> evmongoose

	            Configuration  --->

	                SSl (mbedtls)  --->

	

	make package/evmongoose/compile V=s

## For General embedded environment

### [First, cross compile Lua](https://github.com/zhaojh329/lua-5.1.5-mod)

### Cross compile lib-ev

	git clone https://github.com/kindy/libev.git

	cd libev/src

	sh ./autogen.sh

	export PATH=/home/zjh/lede/staging_dir/toolchain-mipsel_24kc_gcc-5.4.0_musl/bin:$PATH

	./configure --host=mipsel-openwrt-linux --prefix=`pwd`/obj

	make && make install

	

### Cross compile Lua-ev

	git clone https://github.com/brimworks/lua-ev.git

	cd lua-ev

	export PATH=/home/zjh/lede/staging_dir/toolchain-mipsel_24kc_gcc-5.4.0_musl/bin:$PATH

	

	# xxxxx is your cross compiler with directories

	cmake . -DCMAKE_C_COMPILER=mipsel-openwrt-linux-gcc -DCMAKE_FIND_ROOT_PATH_MODE_PROGRAM=BOTH -DCMAKE_FIND_ROOT_PATH_MODE_LIBRARY=ONLY -DCMAKE_FIND_ROOT_PATH_MODE_INCLUDE=ONLY -DCMAKE_FIND_ROOT_PATH=xxxxx

	make

	

### Cross compile evmongoose

	git clone https://github.com/zhaojh329/evmongoose.git

    cd evmongoose

	export PATH=/home/zjh/lede/staging_dir/toolchain-mipsel_24kc_gcc-5.4.0_musl/bin:$PATH

	

	# xxxxx is your cross compiler with directories

	cmake . -DCMAKE_C_COMPILER=mipsel-openwrt-linux-gcc -DCMAKE_FIND_ROOT_PATH_MODE_PROGRAM=BOTH -DCMAKE_FIND_ROOT_PATH_MODE_LIBRARY=ONLY -DCMAKE_FIND_ROOT_PATH_MODE_INCLUDE=ONLY -DCMAKE_FIND_ROOT_PATH=xxxxx

	make

	

# C API reference manual

Evmongoose dose not change the usage of API in mongoose and libev, 

so please refer to the API Manual of [mongoose](https://docs.cesanta.com/mongoose/master) and libev.

Only one thing to notice is that mg_mgr_poll is no longer invoked when using evmongoose.

In addition, evmongoose added a new API: mg_mgr_set_loop, which is used to set libev's loop for Mgr.

If the function is not called, the Mgr will use the default loop:EV_DEFAULT.

# [Lua API reference manual](https://github.com/zhaojh329/evmongoose/wiki/Lua-API-reference-manual)

# How To Contribute

Feel free to create issues or pull-requests if you have any problems.

**Please read [contributing.md](https://github.com/zhaojh329/evmongoose/blob/master/contributing.md)

before pushing any changes.**

# Thanks for the following project

* [mongoose](https://github.com/cesanta/mongoose)

* [libev](https://github.com/kindy/libev)

* [lua-ev](https://github.com/brimworks/lua-ev)

* [lua-mongoose](https://github.com/shuax/lua-mongoose)

# If the project is helpful to you, please do not hesitate to star. Thank you!