NAME

cgi_this - export the current directory as if it were a cgi-bin

VERSION

version 0.005

SYNOPSIS

## Export the current directory like a cgi-bin
$ cgi_this

## Export the dir_name directory like a cgi-bin
$ cgi_this dir_name

## Start the server on a specific port
$ cgi_this --port 9001

## Set HTTP server to listen for incoming connections on 192.168.0.1
$ cgi_this --host 192.168.0.1

## Announces the HTTP server via Bonjour with the specified name
$ cgi_this --name "My CGI server"

## Inlcude /cgi-bin in your URL
$ cgi_this --cgi-bin

## Show documentation about our options
$ cgi_this --help

## Show the entire man page
$ cgi_this --man

DESCRIPTION

Like http_this and https_this, but converts the directory to a cgi-bin and runs every script in it as a CGI script. This is useful for testing old CGI scripts when you don't have a web server installed.

OPTIONS

The following options are available:

--port PORT

Start the HTTP server on a specific PORT. Default is 3000.

--host IP_ADDRESS

Set HTTP server to listen for incoming connections on IP_ADDRESS. Default is 127.0.0.1.

--name NAME

Announces the server over Bonjour.

This feature requires the Net::Rendezvous::Publish module and the appropriate backend for your operating system, both available from CPAN. If one of them cannot be found, a warning message will be displayed.

--cgi-bin

Include the /cgi-bin directory in the URL of your scripts. For the cozy legacy feeling.

--help

Print information about the script usage and its options.

--man

Print the entire man page for the command.

EXAMPLES

The t/ directory of this distribution contains a few examples. Here is how to use them.

$ cgi_this t
Exporting 't', available at:
http://127.0.0.1:3000/

Found the following scripts:
    http://127.0.0.1:3000/test-no-bin.cgi
    http://127.0.0.1:3000/bin/test.pl    

At this point you can visit the URLs in your browser and see the scripts in action.

If want some nostalgia, enable the --cgi-bin option. It will stick a fake /cgi-bin in the URL.

$ cgi_this --cgi-bin t
Exporting 't', available at:
http://127.0.0.1:3000/

Found the following scripts:
    http://127.0.0.1:3000/cgi-bin/test-no-bin.cgi
    http://127.0.0.1:3000/cgi-bin/bin/test.pl

SEE ALSO

At the the Swiss Perl Workshop in 2018 Julien gave a talk about this and similar modules, titled "Do stuff with _this". You can find a recording here.

AUTHOR

simbabque <simbabque@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2017 by simbabque.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.