rt

An interface to the Request Tracker API

https://github.com/nceas/rt

Science Score: 10.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 4 committers (25.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.6%) to scientific vocabulary

Keywords

api request-tracker rstats
Last synced: 10 months ago · JSON representation

Repository

An interface to the Request Tracker API

Basic Info
Statistics
  • Stars: 6
  • Watchers: 5
  • Forks: 4
  • Open Issues: 8
  • Releases: 0
Topics
api request-tracker rstats
Created over 8 years ago · Last pushed about 5 years ago
Metadata Files
Readme License

README.md

Project Status: Active – The project has reached a stable, usable state and is being actively developed. CI Tests cran version

rt

An interface to the RequestTracker API.

Installation

r install.packages("rt")

Usage

Setup

To start using the rt 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.

Below, we log into Best Practical's demo installation of RT:

```r library(rt)

Sys.setenv("RTBASEURL" = "https://demo.bestpractical.com") rt_login() # Enter demo/demo ```

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()

Note: Most of these functions support being chained together (for example, with the %>%).

See the included vignettes for more information about usage.

Logging out

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

r rt_logout()

Development & Testing

A test suite is provided that is comprised mostly of integration tests that are configured to run against a local installation of RT. By default, running devtools::test() will only run a small subset of the full test suite: those that do not depend on being able to call out to an RT installation (i.e., unit tests).

To run the full test suite locally,

  1. Start a local RT installation with Docker:

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

  2. Turn on integration tests for your session

    r Sys.setenv("RT_INTEGRATION" = TRUE)

  3. Run devtools::test() from the same session as (2)

rt_api objects

All API calls go through an intermediate state as an rt_api object, which is made up of three parts:

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

This is mainly to help normalize out some of the inconsistencies in the RT API itself and make implementing the API call wrappers easier.

Support / Issues / Feedback

Let us know about any issues or bugs.

Acknowledgements

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.

nceas_footer

Owner

  • Name: National Center for Ecological Analysis and Synthesis
  • Login: NCEAS
  • Kind: organization
  • Email: help@nceas.ucsb.edu
  • Location: Santa Barbara, CA

GitHub Events

Total
Last Year

Committers

Last synced: over 2 years ago

All Time
  • Total Commits: 268
  • Total Committers: 4
  • Avg Commits per committer: 67.0
  • Development Distribution Score (DDS): 0.287
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Bryce Mecum p****h@g****m 191
Irene 2****s 61
Irene j****e@e****m 15
Mitchell Maier m****r@u****u 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 29
  • Total pull requests: 13
  • Average time to close issues: 8 months
  • Average time to close pull requests: 2 days
  • Total issue authors: 3
  • Total pull request authors: 3
  • Average comments per issue: 2.1
  • Average comments per pull request: 1.54
  • Merged pull requests: 13
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • amoeba (19)
  • isteves (9)
  • dmullen17 (1)
Pull Request Authors
  • isteves (11)
  • maier-m (1)
  • amoeba (1)
Top Labels
Issue Labels
enhancement (7) in progress (4) bug (3) backlog (2) help wanted (1) good first issue (1)
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • cran 296 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 3
  • Total maintainers: 1
cran.r-project.org: rt

Interface to the 'Request Tracker' API

  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 296 Last month
Rankings
Forks count: 12.2%
Stargazers count: 22.0%
Average: 23.6%
Dependent repos count: 24.0%
Dependent packages count: 28.8%
Downloads: 31.3%
Maintainers (1)
Last synced: 11 months ago

Dependencies

DESCRIPTION cran
  • httr * imports
  • stringr * imports
  • askpass * suggests
  • knitr * suggests
  • rmarkdown * suggests
  • testthat * suggests
  • tibble * suggests