NAME

Gantry::Utils::CRON - a way to call a controller's method from a CRON script

SYNOPSIS

  use strict; use warnings;

  use Gantry::Utils::CRON;

  my $cron = Gantry::Utils::CRON->new( {
    controller      => 'Apps::RR::InvoiceMunger::Batch',
    conf_instance   => 'apps_rr_invoicemunger_dev_prod',
    conf_file       => '/etc/gantry.conf',         # optional
    template_engine => 'TT',                       # optional
    namespace       => 'Apps::RR::InvoiceMunger',  # optional
  } );

  # alternative setters
  $cron->set_controller( 'Apps::RR::InvoiceMunger::Batch' );
  $cron->set_conf_instance( 'invoice_munger_prod' );
  $cron->set_conf_file( '/etc/gantry.conf' );
  $cron->set_template_engine( 'TT' );    
  $cron->set_namespace( 'mynamespace' );

  $cron->run( {
    method => 'do_process_files',          # do_* required
    args   => [ '1', '2' ],                # optional
    params => { confirm => 1, test => 3 }  # optional
    type   => 'post'                       # or 'get' -- optional 
  } );

  print STDERR $cron->status();  
  print STDERR $cron->content();

DESCRIPTION

This module is a utility to run a Gantry do_ method from a CRON script

METHODS

new( {} );

Standard constructor, call it first.

Required

    controller      - Gantry controller that contains the do_ method
    conf_instance   - Gantry conf instance name

Optional

    conf_file       - defaults to '/etc/gantry.conf'
    template_engine - defaults to 'TT'
    namespace       

run( {} )

This method executes the defined controller's do_ method.

Accepts

  method - the do_ method
  args   - array of args to be passed to the method
  params - hashref of params to be passed to method
  type   - 'get' or 'post' defaults to 'post' 

Returns

  status  - page status code
  content - plain-text version of method's returned content
        

set_content

setter for the returned content

content

getter for the returned content

set_status

setter for the returned status

status

getter for the returned status

set_controller

setter for controller

controller

getter for controller

set_conf_instance

setter for the Gantry conf_instance

conf_instance

getter for the Gantry conf_instance

set_conf_file

setter for the Gantry conf_file.

conf_file

getter for the Gantry conf_file. Defaults to /etc/gantry.conf

SEE ALSO

Gantry(3)

LIMITATIONS

This module depends on Gantry(3), HTML::TreeBuilder, HTML::FormatText

AUTHOR

Tim Keefer <tim@timkeefer.com>

COPYRIGHT and LICENSE

Copyright (c) 2007, Tim Keefer.

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.