NAME

Qudo - simple and extensible job queue manager

SYNOPSIS

    # enqueue job:
    use Qudo;
    my $qudo = Qudo->new(
        driver_class => 'Skinny', # optional.
        databases => [+{
            dsn      => 'dbi:SQLite:/tmp/qudo.db',
            username => '',
            password => '',
        }],
    );
    $qudo->enqueue("Worker::Test", { arg => 'arg', uniqkey => 'uniqkey'});
    
    # do work:
    use Qudo;
    my $qudo2 = Qudo->new(
        driver_class => 'Skinny', # optional.
        databases => [+{
            dsn      => 'dbi:SQLite:/tmp/qudo.db',
            username => '',
            password => '',
        }],
        manager_abilities => [qw/Worker::Test/],
    );
    $qudo2->work(); # boot manager
    # work work work!

DESCRIPTION

Qudo is simple and extensible job queue manager system.

Your application can insert job into DB ,that is managed by Qudo. And Your application can get & execute job by Qudo worker. Qudo corresponds to deal with DB as MySQL and SQLite.

If you add Hook Point around job's working method , you can add it easily and many point of work milestone. Qudo is consided about adding Hook Point Flexibility.

USEAGE

"Qudo->new( %args )"

Optional members of %args are:

"driver_class"
set Qudo::Driver::(Skinny|DBI). default driver_class is Skinny.
"databases"
An arrayref of database information. Qudo can use multiple databases, such that if any of them are unavailable, the worker will search for appropriate jobs in the other databases automatically.

Each member of the "databases" value should be a hashref containing either:

"dsn"
The database DSN for this database.
"username"
The username to use when connecting to this database.
"password"
The password to use when connecting to this database.

"manager_abilities"
An arrayref of worker class name. please specify it when moving it by the usage of worker. it is not necessary to specify it for the usage of enqueue client.
"find_job_limit_size"
The maximum number in which it looks for job by one processing. Qudo default limit 30. please specify it when moving it by the usage of worker. it is not necessary to specify it for the usage of enqueue client.
"retry_seconds"
The number of seconds after which to try reconnecting to apparently dead databases. If not given, Qudo will retry connecting to databases after 30 seconds.
"default_hooks"
An arrayref of hook class name.
"default_plugins"
An arrayref of plugin class name.

"Qudo->manager"

get Qudo::Manager instance. see Qudo::Manager

"Qudo->enqueue( %args )"

see Qudo::Manager enqueue method.

"Qudo->work( %args )"

Find and perform any jobs $manager can do, forever.

When no job is available, the working process will sleep for $delay seconds (or 5, if not specified) before looking again.

"Qudo->job_count( $funcname, $dsn )"

Returns a job count infomations. The required arguments :

"funcname"
the name of the function or a reference to an array of functions.
"dsn"
The database DSN for job count target database.

"Qudo->exception_list( $args, $dsn )"

Returns a job exception infomations. Optional members of $args are:

•: args

limit
get exception log limit size. default by 10.
offset
get exception log offset size. default by 0.

•: "dsn"
The database DSN for job count target database.

"Qudo->job_status_list( $args, $dsn )"

Returns a job exception infomations. Optional members of $args are:

•: args

limit
get job_status log limit size. default by 10.
offset
get job_status log offset size. default by 0.

•: "dsn"
The database DSN for job count target database.

REPOS

http://github.com/nekokak/qudo/tree/master

AUTHOR

Atsushi Kobayashi <nekokak _at_ gmail dot com>

Masaru Hoshino <masartz _at_ gmail dot com>

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.