view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        t/TEST -verbose t/01.api.t

  Makefile.PL options
    Here are the available options to use when building the "Makefile.PL":

    "-access_module_name"
        access module name

    "-apxs"
        location of apxs (default is from Apache2::BuildConfig)

    "-auth_module_name"
        auth module name

    "-bindir"
        Apache bin/ dir (default is "apxs -q BINDIR")

    "-cgi_module_name"
        cgi module name

    "-defines"
        values to add as "-D" defines (for example, "VAR1 VAR2")

    "-documentroot"
        DocumentRoot (default is "$ServerRoot/htdocs"

    "-group"
        Group to run test server as (default is $GROUP)

    "-httpd"
        server to use for testing (default is "$bindir/httpd")

    "-httpd_conf"
        inherit config from this file (default is apxs derived)

    "-httpd_conf_extra"
        inherit additional config from this file

    "-libmodperl"
        path to mod_perl's .so (full or relative to LIBEXECDIR)

    "-limitrequestline"
        global LimitRequestLine setting (default is 128)

    "-maxclients"
        maximum number of concurrent clients (default is minclients+1)

    "-minclients"
        minimum number of concurrent clients (default is 1)

    "-perlpod"
        location of perl pod documents (for testing downloads)

    "-php_module_name"
        php module name

    "-port"
        Port [port_number|select] (default 8529)

    "-proxyssl_url"
        url for testing ProxyPass / https (default is localhost)

    "-sbindir"
        Apache sbin/ dir (default is "apxs -q SBINDIR")

    "-servername"
        ServerName (default is "localhost")

    "-serverroot"
        ServerRoot (default is $t_dir)

    "-src_dir"
        source directory to look for "mod_foos.so"

    "-ssl_module_name"
        ssl module name

    "-sslca"
        location of SSL CA (default is "$t_conf/ssl/ca")

    "-sslcaorg"
        SSL CA organization to use for tests (default is asf)

    "-sslproto"
        SSL/TLS protocol version(s) to test

    "-startup_timeout"
        seconds to wait for the server to start (default is 60)

    "-t_conf"
        the conf/ test directory (default is "$t_dir/conf")

    "-t_conf_file"
        test httpd.conf file (default is "$t_conf/httpd.conf")

    "-t_dir"
        the t/ test directory (default is "$top_dir/t")

    "-t_logs"
        the logs/ test directory (default is "$t_dir/logs")

    "-t_pid_file"
        location of the pid file (default is "$t_logs/httpd.pid")

    "-t_state"
        the state/ test directory (default is "$t_dir/state")

    "-target"
        name of server binary (default is "apxs -q TARGET")

    "-thread_module_name"
        thread module name

    "-threadsperchild"
        number of threads per child when using threaded MPMs (default is 10)

    "-top_dir"
        top-level directory (default is $PWD)

    "-user"
        User to run test server as (default is $USER)

    See also Apache::TestMM for available parameters or you can type on the
    command line:

        perl -MApache::TestConfig -le 'Apache::TestConfig::usage()'

  Tesging options
    For example, specifying a port to use:

        t/TEST -start-httpd -port=34343
        t/TEST -run-tests
        t/TEST -stop-httpd

    You can run "t/TEST -help" to get the list of options. See below as
    well:

    "-breakpoint=bp"
        set breakpoints (multiply bp can be set)

    "-bugreport"
        print the hint how to report problems

    "-clean"
        remove all generated test files

    "-configure"
        force regeneration of httpd.conf (tests will not be run)

    "-debug[=name]"
        start server under debugger name (gdb, ddd, etc.)

    "-get"
        GET url

    "-head"
        HEAD url

    "-header"
        add headers to (get|post|head) request

    "-help"
        display this message

    "-http11"
        run all tests with "HTTP/1.1" (keep alive) requests

    "-no-httpd"
        run the tests without configuring or starting httpd

    "-one-process"
        run the server in single process mode

    "-order=mode"
        run the tests in one of the modes: (repeat|random|SEED)

    "-ping[=block]"
        test if server is running or port in use

    "-post"
        POST url

    "-postamble"
        config to add at the end of "httpd.conf"

    "-preamble"
        config to add at the beginning of "httpd.conf"

    "-proxy"
        proxy requests (default proxy is localhost)

    "-run-tests"
        run the tests

    "-ssl"
        run tests through ssl

    "-start-httpd"
        start the test server

    "-stop-httpd"
        stop the test server

    "-trace=T"
        change tracing default to: warning, notice, info, debug, ...

    "-verbose[=1]"
        verbose output

    See for more information
    <https://perl.apache.org/docs/general/testing/testing.html>

  API CORE MODULES
    Apache2::RequestIO, Apache2::RequestRec

AUTHOR
    Jacques Deguest <jack@deguest.jp>

SEE ALSO
    Apache2::API::DateTime, Apache2::API::Query, Apache2::API::Request,
    Apache2::API::Request::Params, Apache2::API::Request::Upload,
    Apache2::API::Response, Apache2::API::Status

    Apache2::Request, Apache2::RequestRec, Apache2::RequestUtil

COPYRIGHT & LICENSE
    Copyright (c) 2023 DEGUEST Pte. Ltd.

    You can use, copy, modify and redistribute this package and associated
    files under the same terms as Perl itself.