README.md
In amoeba/rt: An R Package for the RT REST API

rt

An R package for the RequestTracker REST API.

You can install the development version from GitHub with:

remotes::install_github("NCEAS/rt")

To start using the rt R package, log in to your RT instance by setting the server URL in using Sys.setenv and use rt_login() to log in and store your session locally:

library(rt)

Sys.setenv("RT_BASE_URL"="https://demo.bestpractical.com")
rt_login()

Once you are successfully logged in, you're all set to use the package. The rt package supports all of the RequestTracker REST API:

General
Login: rt_login()
Logout: rt_logout()
Tickets
Ticket Properties: rt_ticket_properties()
Ticket Links: rt_ticket_links()
Ticket Attachments: rt_ticket_attachments()
Ticket Attachment: rt_ticket_attachment()
Ticket Attachment Content: rt_ticket_attachment_content()
Ticket History: rt_ticket_history()
Ticket History Entry: rt_ticket_history_entry()
Ticket Search: rt_ticket_search()
Ticket Create: rt_ticket_create()
Ticket Edit: rt_ticket_edit()
Tickets History Reply: rt_ticket_history_reply()
Ticket History Comment: rt_ticket_history_comment()
Ticket Links Edit: rt_ticket_links_edit()
Users
User Properties: rt_user_properties()
User Create: rt_user_create()
User Edit: rt_user_edit()
Queues
Queue Properties: rt_queue_properties()

`rt_api` objects

GET calls to the RequestTracker REST API are returned as rt_api objects, a list of 3 elements:

the content, generally returned as a tibble/data frame
the path or URL that was accessed
the HTTP response from the API.

To log out, use the rt_logout function (or restart your R session):

rt_logout()

Note: Credentials for your rt session are stored using httr's automatic re-use of cookies.

A Dockerfile is available at the root of the repository so it's easy to get a test installation of RT up and running. The tests need this to run so make sure to run the following before running the tests:

docker run -d --name rt -p 8080:80 netsandbox/request-tracker

You can then navigate to http://localhost:8080 and log in as user root with password password. Be aware the tests are hard-coded against http://localhost:8080.

Let us know about any issues or bugs.

Support was provided by the National Center for Ecological Analysis and Synthesis, a Center funded by the University of California, Santa Barbara, and the State of California.