/ 
RT-ClientX-GrabBugs-0.005
River stage zero No dependents
/ RT::ClientX::GrabBugs

NAME

RT::ClientX::GrabBugs - download bugs from an RT queue and dump them as RDF

SYNOPSIS

RT::ClientX::GrabBugs
  ->new({
    user      => $rt_username,
    pass      => $rt_password,
    queue     => $rt_queue,
    dest      => './output_file.ttl',
    })
  ->process;

DESCRIPTION

This module downloads bugs from an RT queue and dumps them as RDF.

Constructor

new(%attrs)

Fairly standard Moosey new constructor, accepting a hash of named parameters.

main(@argv)

Alternative constructor. Processes @argv like command-line arguments. e.g.

RT::ClientX::GrabBugs->main('--user=foo', '--pass=bar',
                            '--queue=My-Module');

This constructor uses Getopt::ArgvFile to read additional options from ~/.rt-grabbugs and ./.rt-grabbugs.

The constructor supports the options "--user", "--pass", "--queue" and "--dest".

Attributes

  • server, user, pass

    Details for logging into RT.

  • dest

    The file name where you want to save the data. This defaults to "./meta/rt-bugs.ttl".

  • queue

    Queue to grab bugs for. Assuming that you're grabbing from rt.cpan.org, this corresponds to a CPAN distribution (e.g. "RT-ClientX-GrabBugs").

    If not provided, this module will try to guess which queue you want. It does this by looking for a file called "dist.ini" in the project directory. Within this file, it looks for a line with the following format:

    ;; name="Foo-Bar"

    This type of line is commonly found in dist.ini files designed for Dist::Inkt. If you're using Dist::Zilla it should be possible to add such a line without breaking anything. (Dist::Zilla sees lines beginning with a semicolon as comments.)

  • project_uri

    URI to use for doap:Project in output.

  • queue_model

    An RDF::Trine::Model generated by calling the add_to_model method on each bug in the queue_table list. Here you probably want to rely on the default model that the class builds.

Methods

  • process

    Saves the model from queue_model to the destination dest as Turtle.

    Returns $self.

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=RT-ClientX-GrabBugs.

SEE ALSO

RDF::DOAP.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

This software is copyright (c) 2012, 2014 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.