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.