Home   

Search CPAN

NAME

app.server - A generated server for the [% app_name %] app

SYNOPSIS

    usage: app.server [options] [port]

port defaults to 8080

DESCRIPTION

This is a Gantry::Server based stand alone server for the [% app_name +%] app. It was built to use the [% instance %] Gantry::Conf instance in the docs directory. To change instances or master conf files, use these flags (the all require values):

  • --instance (or -i)

    (Incompatible with --type)

    The full name of your conf instance, defaults to [% instance %].

  • --type (or -t)

    (Incompatible with --instance)

    Use this if you use named config blocks in your Bigtop file. Use the name of the config block as the value for --type. This will build the corresponding instance name as [% instance %]_TYPE, where TYPE is the value of this flag.

    If you don't neither --instance nor --type, the instance you get will be [% instance %].

  • --file (or -f)

    The name of your master Gantry::Conf file, defaults to docs/app.gantry.conf.

Note that the old database specification flags are no longer available. Use the new Gantry::Conf system and its flags.

NAME

Bigtop::CGI::Backend::Gantry - CGI dispatch script generator for the Gantry framework

SYNOPSIS

If your bigtop file includes:

    config {
        CGI Gantry {
            # optional statements:
                # to get a stand alone server:
                    with_server 1;
                # to use FastCGI instead of regular CGI:
                    fast_cgi 1;
        }
    }

and there are controllers in your app section, this module will generate app.cgi when you type:

    bigtop app.bigtop CGI

or

    bigtop app.bigtop all

You can then directly point your httpd.conf directly to the generated app.cgi.

DESCRIPTION

This is a Bigtop backend which generates cgi dispatching scripts for Gantry supported apps.

KEYWORDS

This module does not register any keywords. See Bigtop::CGI for a list of allowed keywords (think app and controller level 'location' and controller level 'rel_location' statements).

METHODS

To keep podcoverage tests happy.

  • backend_block_keywords

    Tells tentmaker that I understand these config section backend block keywords:

            no_gen
            fast_cgi
            with_server
            server_port
            gen_root
            flex_db
            gantry_conf
            template
            instance
            conffile

    Note that instance and conffile are now deprecated in favor of setting gantry_conf to true, which draws the values from the Conf Gantry backend. You may still use them if you like, but that may change in the future.

  • what_do_you_make

    Tells tentmaker what this module makes. Summary: app.server and app.cgi.

  • gen_CGI

    Called by Bigtop::Parser to get me to do my thing.

  • output_cgi

    What I call on the various AST packages to do my thing.

  • setup_template

    Called by Bigtop::Parser so the user can substitute an alternate template for the hard coded one here.

AUTHOR

Phil Crow <crow.phil@gmail.com>

COPYRIGHT and LICENSE

Copyright (C) 2005 by Phil Crow

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.