Project

roart

0.03
No release in over 3 years
Low commit activity in last 3 years
Interface for working with Request Tracker (RT) tickets inspired by ActiveRecord.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

>= 2.5.1

Runtime

>= 1.0.0
 Project Readme

Roart¶ ↑

\___\__o/
/       \

by PJ Davis github.com/pjdavis/roart

DESCRIPTION:¶ ↑

If you are using Best Practical's Request Tracker (RT) and you need to interact with tickets from other applications, Roart provides an interface that is slightly reminiscent of ActiveRecord.

FEATURES/PROBLEMS:¶ ↑

  • Access RT Tickets through an ActiveRecord like API

  • This has only been tested against RT 3.6. Changes to the REST interface in later versions of RT may break stuff.

SYNOPSIS:¶ ↑

  • Create a class to interact with your ticket system

    require 'rubygems'
    require 'roart'
    
    class Ticket < Roart::Ticket
      connection :server => 'http://my.rt.server.com', :user => 'myuser', :pass => 'mypass'
    
    end
    
  • Search for tickets

    my_tickets = Ticket.find(:all, :queue => 'Scutters', :status => [:new, :open])
    my_tickets.each do |ticket|
      puts ticket.subject
    end
    
    #-> New John Wayne packages
    #-> Medi-lab training
    
  • See all info for a ticket

    my_ticket = Ticket.find(:first, :queue => 'Issues', :status => :new)
    ticket.creator #-> rimmer@reddwarf.com
    ticket.subject #-> Where is the Bomb?
    
  • Get history for a ticket

    my_ticket.histories #-> Returns an array of history objects
    
  • Create a new ticket

    issue = Ticket.new(:queue => 'some_queue', :subject => 'This is not working for me')
    issue.id #-> 'ticket/new'
    issue.save
    issue.id #-> 23423
    
  • Update a ticket

    ticket = Ticket.find(23452)
    ticket.subject #-> "Some Subject for a ticket."
    ticket.subject #-> "Smoke me a kipper, I'll be back for breakfast."
    ticket.save
    ticket.subject #->"Smoke me a kipper, I'll be back for breakfast."
    
  • Comment on a Ticket

    ticket = Ticket.find(23452)
    ticket.comment("This is a lovely Ticket", :time_worked => 45, :cc => 'someone@example.com'))

REQUIREMENTS:¶ ↑

  • mechanize

  • A working RT3 install.

INSTALL:¶ ↑

$ gem sources -a http://gems.github.com
$ sudo gem install pjdavis-roart

LICENSE:¶ ↑

        (C) PJ Davis <pj.davis@gmail.com>

This program is free software; you can redistribute it and/or modify it under
the terms of the WTFPL, Version 2, as
published by Sam Hocevar. See http://sam.zoy.org/wtfpl/ for more details.