-
Notifications
You must be signed in to change notification settings - Fork 0
/
DESCRIPTION
63 lines (63 loc) · 2.21 KB
/
DESCRIPTION
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
Package: hRvstAPI
Title: This is a wrapper for the Harvest REST API v2.
Version: 0.0.0.9000
Authors@R:
person(
"Eric", "Hunt",
email = "[email protected]",
role = c("aut", "cre"),
comment = c(ORCID = "0000-0002-6891-8294")
)
Description: The foremost function of this package is to act as a *convenient*
wrapper around the Harvest REST API v2.
To that end, the package handles credentials either through the system
keyring using the `keyring` package (preferred), or through environment
variables written to a local `.Renviron` file. Credential handling can be
initiated explicitly, but otherwise happens automatically upon making an
API request.
This package tries to make accessing the Harvest API as easy as possible.
While it does allow some tweaking of the actual HTTP request via function
arguments, the primary method for accessing API data is to simply select
which resource to query (e.g. "users" will download all users data). *Note,
that the default is to only download "active" records.*
The reason for this mode of access is that a request usually isn't very big
and the typical user will probably want to manipulate the data in a more
sophisticated manner for some downstream visualization or other analysis.
Building on this premise, the secondary function of this package is to
manage the long term storage of API data to minimize remote requests. This
is achieved by storing API data in a local SQLite database, for which this
package also provides a straightforward way of accessing and updating with
new data.
There is a companion Shiny application (hRvst) which utilizes this wrapper
for Harvest API data access, and perhaps slightly enhances this package.
License: MIT + file LICENSE
Encoding: UTF-8
Roxygen: list(markdown = TRUE)
RoxygenNote: 7.2.1.9000
Depends: R (>= 4.1)
Imports:
assertthat,
bit64,
DBI,
dplyr,
fs,
getPass,
glue,
httr2,
lubridate,
purrr,
readr,
rlang,
RSQLite,
stringr,
tibble,
withr
Collate:
'access.R'
'params.R'
'creds.R'
'req.R'
'store.R'
'zzz.R'
Suggests:
keyring