Mojolicious::Commands - Command line interface

1. SYNOPSIS
2. DESCRIPTION
3. COMMANDS
   1. cgi
   2. cpanify
   3. daemon
   4. eval
   5. generate
   6. generate app
   7. generate dockerfile
   8. generate lite-app
   9. generate makefile
   10. generate plugin
   11. get
   12. help
   13. inflate
   14. prefork
   15. psgi
   16. routes
   17. version
4. ATTRIBUTES
   1. hint
   2. message
   3. namespaces
5. METHODS
   1. detect
   2. run
   3. start_app
6. SEE ALSO

SYNOPSIS

Usage: APPLICATION COMMAND [OPTIONS]

  mojo version
  mojo generate lite-app
  ./myapp.pl daemon -m production -l http://*:8080
  ./myapp.pl get /foo
  ./myapp.pl routes -v

Tip: CGI and PSGI environments can be automatically detected very often and
     work without commands.

Options (for all commands):
  -h, --help          Get more information on a specific command
      --home <path>   Path to home directory of your application, defaults to
                      the value of MOJO_HOME or auto-detection
  -m, --mode <name>   Operating mode for your application, defaults to the
                      value of MOJO_MODE/PLACK_ENV or "development"

DESCRIPTION

Mojolicious::Commands is the interactive command line interface for the Mojolicious framework. It will automatically detect available commands in the Mojolicious::Command and Mojolicious::Command::Author namespaces.

COMMANDS

These commands are available by default.

cgi

$ ./myapp.pl cgi

Use Mojolicious::Command::cgi to start application with CGI backend, usually auto detected.

cpanify

$ mojo cpanify -u sri -p secr3t Mojolicious-Plugin-Fun-0.1.tar.gz

Use Mojolicious::Command::Author::cpanify for uploading files to CPAN.

daemon

$ ./myapp.pl daemon

Use Mojolicious::Command::daemon to start application with standalone HTTP and WebSocket server.

eval

$ ./myapp.pl eval 'say app->home'

Use Mojolicious::Command::eval to run code against application.

generate

$ mojo generate
$ mojo generate help
$ ./myapp.pl generate help

List available generator commands with short descriptions.

$ mojo generate help <generator>
$ ./myapp.pl generate help <generator>

List available options for generator command with short descriptions.

generate app

$ mojo generate app <AppName>

Use Mojolicious::Command::Author::generate::app to generate application directory structure for a fully functional Mojolicious application.

generate dockerfile

$ ./myapp.pl generate dockerfile
$ ./script/my_app generate dockerfile

Use Mojolicious::Command::Author::generate::dockerfile to generate Dockerfile for application.

generate lite-app

$ mojo generate lite-app

Use Mojolicious::Command::Author::generate::lite_app to generate a fully functional Mojolicious::Lite application.

generate makefile

$ mojo generate makefile
$ ./myapp.pl generate makefile

Use Mojolicious::Command::Author::generate::makefile to generate Makefile.PL file for application.

generate plugin

$ mojo generate plugin <PluginName>

Use Mojolicious::Command::Author::generate::plugin to generate directory structure for a fully functional Mojolicious plugin.

get

$ mojo get https://mojolicious.org
$ ./myapp.pl get /foo

Use Mojolicious::Command::get to perform requests to remote host or local application.

help

$ mojo
$ mojo help
$ ./myapp.pl help

List available commands with short descriptions.

$ mojo help <command>
$ ./myapp.pl help <command>

List available options for the command with short descriptions.

inflate

$ ./myapp.pl inflate

Use Mojolicious::Command::Author::inflate to turn templates and static files embedded in the DATA sections of your application into real files.

prefork

$ ./myapp.pl prefork

Use Mojolicious::Command::prefork to start application with standalone pre-forking HTTP and WebSocket server.

psgi

$ ./myapp.pl psgi

Use Mojolicious::Command::psgi to start application with PSGI backend, usually auto detected.

routes

$ ./myapp.pl routes

Use Mojolicious::Command::routes to list application routes.

version

$ mojo version
$ ./myapp.pl version

Use Mojolicious::Command::version to show version information for available core and optional modules, very useful for debugging.

ATTRIBUTES

Mojolicious::Commands inherits all attributes from Mojolicious::Command and implements the following new ones.

hint

my $hint  = $commands->hint;
$commands = $commands->hint('Foo');

Short hint shown after listing available commands.

message

my $msg   = $commands->message;
$commands = $commands->message('Hello World!');

Short usage message shown before listing available commands.

namespaces

my $namespaces = $commands->namespaces;
$commands      = $commands->namespaces(['MyApp::Command']);

Namespaces to load commands from, defaults to Mojolicious::Command::Author and Mojolicious::Command.

# Add another namespace to load commands from
push @{$commands->namespaces}, 'MyApp::Command';

METHODS

Mojolicious::Commands inherits all methods from Mojolicious::Command and implements the following new ones.

detect

my $env = $commands->detect;

Try to detect environment, or return undef if none could be detected.

run

$commands->run;
$commands->run(@ARGV);

Load and run commands. Automatic deployment environment detection can be disabled with the MOJO_NO_DETECT environment variable.

start_app

Mojolicious::Commands->start_app('MyApp');
Mojolicious::Commands->start_app(MyApp => @ARGV);

Load application from class and start the command line interface for it. Note that the options -h/--help, --home and -m/--mode, which are shared by all commands, will be parsed from @ARGV during compile time.

# Always start daemon for application
Mojolicious::Commands->start_app('MyApp', 'daemon', '-l', 'http://*:8080');

SEE ALSO

Mojolicious, Mojolicious::Guides, https://mojolicious.org.