NAME

http_this - export the current directory over HTTP

VERSION

version 0.006

SYNOPSIS

    ## Export the current directory with HTTP
    $ http_this

    ## Export the dir_name directory with HTTP
    $ http_this dir_name

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

    ## Announces the HTTP server via Bonjour with the specified name
    $ http_this --name "My cool webserver"

    ## Start the server using index.html for directory requests
    $ http_this --autoindex

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

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

DESCRIPTION

The http_this command exports the current directory via HTTP. You can also export any directory by providing the path as a parameter.

A simple web server is started and is kept running until you kill it with Ctrl-C.

All the files and directories will be availble to a browser under the URL the script outputs.

ARGUMENTS

The script accepts a single optional argument: the path of the directory to export.

OPTIONS

The following options are available:

--port PORT

Start the HTTP server on a specific PORT.

--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.

--autoindex

By default, if the server gets a request that ends in / then it displays a listing of that directory. With the --autoindex flag, it will serve the index.html file from that directory (if it exists).

--help

Print information about the script usage and its options.

--man

Print the entire man page for the command.

AUTHOR

Pedro Melo <melo@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2010 by Pedro Melo.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)