awesome-resty

awesome-resty is a list of OpenResty / Nginx modules, Lua libraries, and related resources.

Official Channels

Web Site: http://openresty.org/
Mailing List: https://groups.google.com/forum/#!forum/openresty-en (Chinese List)
Github Organization: https://github.com/openresty
Lead Developer: @agentzh

How to Contribute on this List?

Create a New Issue where you describe the needed additions, deletions or changes.
Fork this repository and make the changes, and create a pull request.
Post a reply in the awesome-resty thread in openresty-en mailing list.

Modules
Libraries
Books and Tutorials
- Books
- Tutorials and Guides
Conferences, Workshops and Events
See Also

Modules

Core Modules

Core modules come bundled in OpenResty package.

ngx_openresty — Turning Nginx into a full-fledged Web App Server - Sources for OpenResty Bundle Generation
lua-nginx-module — Embed the power of Lua into Nginx
echo-nginx-module — An Nginx module for bringing the power of "echo", "sleep", "time" and more to Nginx's config file
xss-nginx-module — Native support for cross-site scripting (XSS) in an nginx
set-misc-nginx-module — Various set_xxx directives added to nginx's rewrite module (md5/sha1, sql/json quoting, and many more)
encrypted-session-nginx-module — Encrypt and decrypt Nginx variable values
srcache-nginx-module — Transparent subrequest-based caching layout for arbitrary nginx locations
lua-upstream-nginx-module — Nginx C module to expose Lua API to ngx_lua for Nginx upstreams
headers-more-nginx-module — Set and clear input and output headers...more than "add"!
array-var-nginx-module — Add support for array variables to nginx config files
memc-nginx-module — An extended version of the standard memcached module that supports set, add, delete, and many more memcached commands
redis2-nginx-module — Nginx upstream module for the Redis 2.0 protocol
rds-json-nginx-module — An nginx output filter that formats Resty DBD Streams generated by ngx_drizzle and others to JSON
rds-csv-nginx-module — Nginx output filter module to convert Resty-DBD-Streams (RDS) to Comma-Separated Values (CSV)
drizzle-nginx-module — An Nginx upstream module that talks to mysql and drizzle by libdrizzle
ngx_postgres — Upstream module that allows Nginx to communicate directly with PostgreSQL database
form-input-nginx-module — This is a nginx module that reads HTTP POST and PUT request body encoded in "application/x-www-form-urlencoded", and parse the arguments in request body into nginx variables.
ngx_coolkit — Collection of small and useful nginx add-ons

Please also note that there is resty command line client included in OpenResty bundle. The command line client sources can be found on Github.

Core Nginx Modules

Please refer Nginx Documentation about the Core Nginx Modules.

Third-party Nginx Modules

ngx_pagespeed (Github) — Automatic PageSpeed optimization module for Nginx
ModSecurity — Open Source Web Application Firewall
NAXSI — NAXSI is an open-source, high performance, low rules maintenance WAF for NGINX; NAXSI means Nginx Anti Xss & Sql Injection

Libraries

Core Libraries

Core Libraries are bundled in OpenResty package, and you don't need to separately install them.

lua-resty-core - New FFI-based Lua API for the ngx_lua module
lua-resty-upstream-healthcheck — Health Checker for Nginx Upstream Servers in Pure Lua
lua-resty-string — String utilities and common hash functions for ngx_lua and LuaJIT
lua-resty-lock — Simple nonblocking lock API for ngx_lua based on shared memory dictionaries
lua-resty-lrucache — Lua-land LRU Cache based on LuaJIT FFI
lua-resty-dns — DNS resolver for the Nginx Lua module
lua-resty-upload — Streaming reader and parser for HTTP file uploading based on ngx_lua cosocket
lua-resty-websocket — Lua WebSocket implementation for the ngx_lua module
lua-resty-mysql — Non-blocking Lua MySQL client driver for ngx_lua based on the cosocket API
lua-resty-memcached — Lua memcached client driver for the ngx_lua based on the cosocket API
lua-resty-redis — Lua Redis client driver for the ngx_lua based on the cosocket API
lua-redis-parser — Redis reply parser and request constructor library for Lua
lua-rds-parser — Resty-DBD-Stream (RDS) parser for Lua written in C
lua-cjson — Lua cJSON is a fast JSON encoding / parsing module for Lua

Web Frameworks

Lapis — Lapis is a framework for building web applications using MoonScript or Lua that runs inside of a customized version of Nginx called OpenResty
Lusty — Lua RESTful Web Application Framework, an extensible and speedy web framework
GIN — A fast, low-latency, low-memory footprint, web JSON-API framework with Test Driven Development helpers and patterns
Quick Server — A Server Framework Based on OpenResty
Sailor — A Lua MVC Web Framework
lua-resty-rack — A simple and extensible HTTP server framework for OpenResty
Vanilla — An OpenResty Web Framework
MOOCHINE — A simple and lightweight web framework based on OpenResty
sinatra-openresty — Sinatra ported to OpenResty framework
lj-web — Lightweight Web Framework Based On ngx_openresty
Gimlet Cocktail — A micro web application framework for OpenResty written in Moonscript inspired by Martini & Sinatra
durap — Durap is a Lua Web Framework based on OpenResty.
Ziggy Stardust — Ziggy Stardust (or just "stardust") is a simple nginx/Lua framework inspired by Sinatra, Express, and Mercury
zLua — A Codeigniter like Lua framework based on OpenResty
lua-resty-stack — OpenResty Simple Application Stack
dodolu — A lightweight web framework based on OpenResty
Octopus (Github) — The Lua Web Platform

Web Development Essentials

lua-resty-cookie — Lua library for HTTP cookie manipulations for OpenResty/ngx_lua
lua-resty-session — Session library for OpenResty implementing Secure Cookie Protocol
lua-resty-woothee — The Lua-Openresty implementation of Project Woothee, which is a multi-language user-agent strings parsers
router.lua — A barebones router for Lua, it matches urls and executes lua functions
lua-resty-mobile — This library parses HTTP headers and detects mobile device*
lua-resty-jwt — JWT (JSON Web Tokens) for The Great OpenResty
lua-resty-post — HTTP Post Utility for OpenResty (File Uploading Helper)
neturl — URL and Query string parser, builder, normalizer for Lua

Middleware and API Tools

Kong (GitHub) — KONG: Microservice Management Layer (Secure, Manage & Extend your APIs and Microservices)

Templating

lua-resty-template — A Compiling (HTML) templating engine for Lua and OpenResty
etlua — Embedded Lua templates
Alternatives — Some alternative Lua templating solutions that may work just fine with OpenResty

Cryptography

lua-resty-string — String utilities and common hash functions for ngx_lua and LuaJIT
lua-resty-nettle — LuaJIT FFI bindings for Nettle (a low-level cryptographic library)
lua-resty-murmurhash2 — LuaJIT MurmurHash 2 bindings to Nginx / OpenResty murmurhash2 implementation
lua-resty-hmac — Lua driver for making and receiving hmac signed requests
lua-resty-scrypt — LuaJIT FFI-based scrypt library for OpenResty
lua-resty-rsa — RSA functions for LuaJIT
lua-resty-hawk — Hawk authentication on Nginx with Lua and OpenResty

Networking

lua-resty-http by @pintsized — Lua HTTP client cosocket driver for OpenResty / ngx_lua
lua-resty-http by @liseen — Lua http client driver for the ngx_lua based on the cosocket API
lua-resty-http by @DorianGray — Lua HTTP client driver for ngx_lua based on the cosocket API
lua-resty-http-simple — Simple Lua HTTP client driver for ngx_lua
lua-resty-httpipe — Lua HTTP client cosocket driver for OpenResty / ngx_lua
lua-resty-httpclient — Nonblocking Lua HTTP Client library for aLiLua & ngx_lua
lua-httpcli-resty — Lua HTTP client module for OpenResty
lua-resty-websocket — Lua WebSocket implementation for the ngx_lua module
lua-resty-iputils — Utility functions for working with IP addresses in OpenResty
lua-resty-readurl — Lua library for capturing urls, decoding, and logging results
FreeWAF — High-performance WAF built on the OpenResty stack
lua-resty-tarpit — OpenResty response time inflation, capture and delay unwanted requests
lua-resty-jsonrpc-batch — JSON-RPC 2.0 Batch Request protocol module for OpenResty
lua-resty-limit-traffic — Lua library for limiting and controlling traffic in OpenResty/ngx_lua
lua-resty-limits — Limits request every second or minute
lua-resty-fastcgi — Lua FCGI client driver for ngx_lua based on the cosocket API
lua-resty-ftpclient — Lua FTP client driver for the ngx_lua based on the cosocket API

Databases and Storages

lua-resty-mysql — Non-blocking Lua MySQL client driver for ngx_lua based on the cosocket API
lua-resty-postgres — Nonblocking Lua PostgreSQL driver library for ngx_lua
pgmoon — A pure Lua Postgres driver for use in OpenResy & more
lua-resty-memcached — Lua memcached client driver for the ngx_lua based on the cosocket API
lua-resty-redis — Lua Redis client driver for the ngx_lua based on the cosocket API
lua-resty-redis-connector — Connection utilities for lua-resty-redis, making it easy and reliable to connect to Redis hosts, either directly or via Redis Sentinel
lua-resty-cassandra (See also: Mashape Fork) — Pure Lua Cassandra client using CQL binary protocol
lua-resty-riak — Lua riak protocol buffer client driver for the ngx_lua based on the cosocket API
lua-resty-mongol — Native Lua Mongodb driver which supports both luasocket and ngx_lua based on the cosocket API
lua-resty-mongo — Lua mongodb client driver for the ngx_lua based on the cosocket API
lua-mongo — A simple Lua Mongo driver (a fork made to work with co-sockets)
lua-resty-kyototycoon — Lua client driver for KyotoTycoon using its native wire protocol (OpenResty/ngx_lua)
lua-resty-tarantool — Library for working with Tarantool from Nginx with the embedded Lua module or with OpeRresty
lua-nginx-tarantool — A driver for a NoSQL database in a Lua script Tarantool build on fast nginx cosockets
lua-resty-ssdb — Lua ssdb client driver for the ngx_lua based on the cosocket API, SSDB is a leveldb server
ledis-openresty — Lua LedisDB client driver for the ngx_lua based on the cosocket API
lua-resty-fastdfs — Nonblocking Lua FastDFS driver library for ngx_lua
openresty-statsd — A Lua module for OpenResty to send metrics to StatsD

Testing and Profiling

Test::Nginx — Data-driven test scaffold for Nginx C module and OpenResty Lua library development (see real-word tests in lua-resty-redis)
nginx-systemtap-toolkit — Real-time analyzing and diagnosing tools for Nginx based on SystemTap
stapxx — Simple macro language extentions to systemtap
FlameGraph — Flame graphs are a visualization of profiled software, allowing the most frequent code-paths to be identified quickly and accurately
lua-resty-test — Test frame based on OpenResty
busted (Github) — Elegant Lua unit testing
Telescope (Github) — Telescope is a highly customizable test library for Lua that allows for declarative tests with nested contexts

Message Queuing and Task Management

lua-resty-qless — Lua binding to Qless (Queue / Pipeline management) for OpenResty (see also: Qless Web Interface implemented with OpenResty)
lua-resty-rabbitmqstomp — Lua RabbitMQ client library which uses cosocket api for communication over STOMP 1.2 with a RabbitMQ broker which has the STOMP plugin
lua-resty-gearman — Lua gearman client driver for the ngx_lua based on the cosocket API
lua-resty-kafka — Lua kafka client driver for the ngx_lua based on the cosocket API
lua-resty-beanstalkd — Lua beanstalkd client driver for the ngx_lua based on the cosocket API
lua-resty-ironmq — Simple IronMQ client for OpenResty

Bar Codes and QR Codes

lua-resty-QRcode — QR encode tool for ngx_lua
lua-resty-QRDecode — QR decoder for ngx_lua

Utilities

lua-resty-fileinfo — LuaJIT FFI bindings to libmagic, magic number recognition library - tries to determine file types
lua-resty-taglib - LuaJIT FFI bindings for TagLib - An Audio Meta-Data Library
lua-resty-uuid — LuaJIT FFI bindings for libuuid, a DCE compatible Universally Unique Identifier library

Date and Time

These libraries are not build to using lua-nginx-modules date time functions (except luatz) like ngx.today, ngx.time, ngx.now, ngx.localtime, or ngx.utctime, but they may still come handy. At some point we may need a more "official" time library for OpenResty.

luatz — A Lua library for time and date manipulation (has a fallback to ngx.now)
LuaDate — Lua Date and Time module for Lua 5.x
SciLua Time Library — Library for the manipulation of dates and periods according to the Gregorian calendar, i.e. the internationally accepted calendar for most uses

Compression

lua-resty-snappy — LuaJIT FFI bindings for Snappy, a fast compressor/decompressor

Text Formats

lua-resty-hoedown — LuaJIT FFI bindings to Hoedown, a standards compliant, fast, secure markdown processing library in C
lua-gumbo — Lua bindings for the Gumbo HTML5 parsing library, with a set of DOM APIs implemented in pure Lua
lua-re2 — C and Lua wrapper for RE2 regular expression library.
lua-aho-corasick — C++ and Lua Implementation of the Aho-Corasick (AC) string matching algorithm
lua-resty-prettycjson — Lua cJSON Pretty Formatter

Document Formats

lua-resty-libxl — LuaJIT FFI-based LibXL (Excel) library for OpenResty
lua-resty-hpdf — LuaJIT FFI-based libHaru (PDF) library for OpenResty

Image Formats

Lua IMagick — Lua Pure-C Bindings to ImageMagick
magick — Lua Bindings to ImageMagick for LuaJIT using FFI
giflib — Lua bindings to GIFLIB for LuaJIT using FFI
fi-luajit — A LuaJIT interface to FreeImage

Localization

lua-resty-gettext — LuaJIT FFI-based gettext library for OpenResty

Caching

lua-resty-lrucache — Lua-land LRU Cache based on LuaJIT FFI
Ledge — A Lua application for OpenResty, providing HTTP cache functionality for Nginx, using Redis as a cache / metadata store
lua-resty-cache — HTTP Cache to Redis, can serve stale response, and using lua-resty-lock only allow one request to populate a new cache

Metrics and Statistics

LUAMETER — A Lua module for Nginx that records and provides key status and performance metrics, right from within Nginx and in real-time (Proprietary)
ngxtop — Real-Time metrics for nginx server

Logging

lua-resty-logger-socket — Raw-socket-based Logger Library for Nginx (based on ngx_lua)
raven-lua — A small Lua interface to Sentry
lua-nginx-logging — Logging utilities for Nginx written in Lua
lua-resty-logger — Custom Logger Library for OpenResty

Web APIs

lua-resty-github — Lua library for using the github api in the ngx_lua nginx module
lua-resty-hipchat — Lua library for using the hipchat api
lua-resty-aws — AWS signature V4 library for OpenResty + Lua
lua-resty-s3 — Lua driver for uploading content to Amazon S3
lua-resty-paypal — Lua Paypal client using express checkout for OpenResty
lua-resty-17monip — 17MonIP parsing library for ngx_lua
lua-resty-upyun — Upyun cloud-based platform

Other Sources for Libraries

Books and Tutorials

Books

OpenResty Best Practices (GitBook) (Chinese, use e.g. Google Translate)

Tutorials and Guides

agentzh's Nginx Tutorials
Definitely an OpenResty Guide
The Latest and Greatest from ngx_lua: New Features & Tools (Summary, Slides, PDF, Video)
Nginx Configuration Snippets — A collection of useful Nginx configuration snippets

Conferences, Workshops and Events

OpenResty Con 2015, Beijing, China (tickets) (19wu.com)

alexlis / awesome-resty Goto Github PK

awesome-resty's Introduction