RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/openresty/meta-lua-nginx-module below:

openresty/meta-lua-nginx-module: Meta Lua Nginx Module supporting both Http Lua Module and Stream Lua Module

meta-lua-nginx-module - templates and toolchains for generating http-lua-nginx-module and stream-lua-nginx-module.

$ make SUBSYS=stream DESTDIR=/path/to/stream-lua-nginx-module/src -j4

All make options are optional.

Option Meaning Default SUBSYS Subsystem this build is for http DESTDIR Directory the generated files should go build/src

├── src: all source files
│   ├── http: http subsystem specific files, not rendered by the template engine
│   ├── stream: stream subsystem specific files, not rendered by the template engine
│   └── subsystem: templates file that are shared between subsystems, rendered by the template engine
└── utils: build toolchains

Back to TOC

First, determine where the change should go to. As an example, if you would like to change a file inside lua-nginx-module, that file could either be rendered through the template engine, or be simply copied from the src/http directory as-is without going through the template engine.

To tell which one is the case, look at the first few lines of the generated file. A file rendered by the template engine will have something like this at it's beginning:

/*
 * !!! DO NOT EDIT, YOUR CHANGES WILL BE OVERWRITTEN !!!
 * Generated from: src/subsystem/ngx_subsystem_foo.c.tt2
 */

Next, edit the file and use command similar to the following to build the new source code:

$ make SUBSYS=http DESTDIR=../lua-nginx-module/src -j4

Next, update the tests inside the respective repository. In this case, they will be under ../lua-nginx-module/t.

Finally, create PRs for both the meta-lua-nginx-module and lua-nginx-module.

Back to TOC

All the files under src/subsystem are valid Perl TT2 files and should be renderable using the mini-tt2.pl tool inside this repo, the lemplate or the official Perl TT2 renderer.

Note: The mini-tt2.pl tool has been specifically tailored for rendering C source codes and will reformat to make sure the rendered file follows the general styling guidelines of NGINX and OpenResty projects. Rendering using other TT2 compatible renderers should yield files that can be build but not necessarily correct in terms of styling.

In general, you should always use the mini-tt2.pl tool while working with this repository and only submit files rendered by it to lua-nginx-module and stream-lua-nginx-module. You should also avoid using any TT2 features that the mini-tt2.pl tool does not support unless there is a very good reason to do so.

The mini-tt2.pl tool supports the following subset of TT2 features:

Back to TOC

[% foo = 'abc' %]
[% SET foo = 'def' %]

Note that SET is optional and both forms above are equivalent.

Back to TOC

[% IF foo == 'abc' %]
Foo is abc!
[% ELSIF subsys %]
Foo is not abc!
[% END %]


[% IF foo == 'def' %]
Foo is def!
[% END %]

Back to TOC

[%# this will not appear inside rendered file #%]

Back to TOC

[% BLOCK snippet %]
I am a snippet.
[% END %]

[% INCLUDE snippet %]
Hello!
[% PROCESS snippet %]

This will be rendered as:

I am a snippet.
Hello!
I am a snippet.

Note: Passing variables to block is not supported. INCLUDE and PROCESS directives are equivalent.

Back to TOC

For convenience, the mini-tt2.pl tool always automatically inject the following variables into the template context:

Their value depends only on the SUBSYS option passed when invoking make.

Note: Variable names in TT2 are case-sensitive.

Variable Type Value when SUBSYS == "http" Value when SUBSYS == "stream" subsys String "http" "stream" SUBSYS String "HTTP" "STREAM" req_type String "ngx_http_request_t" "ngx_stream_lua_request_t" req_subsys String "http" "stream_lua" http_subsys Boolean 1 0 stream_subsys Boolean 0 1

Back to TOC

Whitespace control using output modifiers like [% foo -%] is not necessary. The mini-tt2.pl tool always suppresses whitespaces caused by template directives in the rendered files.

Back to TOC

The openresty-en mailing list is for English speakers.

Back to TOC

The openresty mailing list is for Chinese speakers.

Back to TOC

This repository is licensed under the BSD license.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Back to TOC

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4