Initial Checkin

Author: Taymindis

LICENSE

@@ -1,25 +1,33 @@
-BSD 2-Clause License
-
-Copyright (c) 2022, Taymindis Woon
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. 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.
+/**
+* @file   ngx_http_if_request_body_module.c
+* @author taymindis <minikawoon99@gmail.com>
+* @date   Sat MAR 26 12:06:52 2022
+*
+* @brief  A nginx-if-request-body module for Nginx.
+*
+* @section LICENSE
+*
+* Copyright (c) 2022, Taymindis <minikawoon99@gmail.com>
+*
+* This module is licensed under the terms of the BSD license.
+*
+* Redistribution and use in source and binary forms, with or without
+* modification, are permitted provided that the following conditions are met:
+*
+* 1. Redistributions of source code must retain the above copyright notice, this
+*    list of conditions and the following disclaimer.
+* 2. 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 OWNER 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.
+*/

README

@@ -0,0 +1,27 @@
+Catch body filter module for nginx.
+
+This is a test module, to check request body filters experimental
+machinery to be introduced.
+
+Example:
+
+```nginx
+    error_page 418 =200 /welcome_if_request_body;
+    location /welcome_if_request_body {
+        add_header Content-Type text/plain;
+        return 200 "welcome_if_request_body, you hit it";
+    }
+
+    location = / {
+        if_request_body on;
+        return_status_if_body_eq "ASD" 418 on;
+        return_status_if_body_eq "foo" 418;
+        return_status_if_body_eq "john" 418;
+        return_status_if_body_startswith "report" 418;
+        return_status_if_body_contains "report" 418;
+        return_status_if_body_regex "^[\d]+?abc" 418;
+        proxy_pass http://localhost:7777;
+        
+    }
+
+```

config

@@ -0,0 +1,17 @@
+# (C) Taymindis Woon
+# Configuration for ngx_http_if_request_body_module.
+
+ngx_addon_name="ngx_http_if_request_body_module"
+
+if test -n "$ngx_module_link"; then
+    ngx_module_type=HTTP
+    ngx_module_name=$ngx_addon_name
+    ngx_module_deps="$NGX_ADDON_DEPS"
+    ngx_module_srcs="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_if_request_body_module.c"
+    
+    . auto/module
+else
+  HTTP_MODULES="$HTTP_MODULES $ngx_addon_name"
+  NGX_ADDON_SRCS="$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_if_request_body_module.c"
+  # NGX_ADDON_DEPS="$NGX_ADDON_DEPS $HTTP_LINK_FUNC_DEPS"
+fi