1 package MooseX::Runnable;
4 our $VERSION = '0.00_01';
14 MooseX::Runnable - tag a class as a runnable application
18 Create a class, tag it runnable, and provide a C<run> method:
20 package App::HelloWorld;
23 with 'MooseX::Runnable';
31 Then you can run this class as an application with the included
34 $ mx-run App::HelloWorld jrockway
38 C<MooseX::Runnable> supports L<MooseX::Getopt|MooseX::Getopt>, and
39 other similar systems (and is extensible, in case you have written
44 MooseX::Runnable is a framework for making classes runnable
45 applications. This role doesn't do anything other than tell the rest
46 of the framework that your class is a runnable application that has a
47 C<run> method which accepts arguments and returns the process' exit
50 This is a convention that the community has been using for a while.
51 This role tells the computer that your class uses this convention, and
52 let's the computer abstract away some of the tedium this entails.
54 =head1 REQUIRED METHODS
60 This is a script that accepts a C<MooseX::Runnable> class and tries to
61 run it, using C<MooseX::Runnable::Run>.
65 mx-run <args for mx-run> -- Class::Name <args for Class::Name>
69 mx-run -Ilib -- App::HelloWorld --args --go --here
73 mx-run -Ilib +Persistent --port 8080 -Persistent -- App::HelloWorld --args --go --here
74 =head2 C<MooseX::Runnable::Run>
76 If you don't want to invoke your app with C<mx-run>, you can write a
77 custom version using L<MooseX::Runnable::Run|MooseX::Runnable::Run>.