R-oai: Import R package oai-0.3.2 as wip/R-oai

[Brook Milligan <brook%nmsu.edu@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Brook Milligan <brook%nmsu.edu@localhost>
Pushed By:	brook
Date:		Wed Sep 8 13:03:58 2021 -0600
Changeset:	b350aeeb7cea0c0a3aa12b1e15efe868f4c0c675

Modified Files:
	Makefile
Added Files:
	R-oai/DESCR
	R-oai/Makefile
	R-oai/distinfo

Log Message:
R-oai: Import R package oai-0.3.2 as wip/R-oai

`oai` is an R client to work with OAI-PMH (Open Archives Initiative
Protocol for Metadata Harvesting) services, a protocol developed by
the Open Archives Initiative
(https://en.wikipedia.org/wiki/Open_Archives_Initiative). OAI-PMH uses
XML data format transported over HTTP.

OAI-PMH Info:

* Wikipedia
  (https://en.wikipedia.org/wiki/Open_Archives_Initiative_Protocol_for_Metadata_Harvesting)
* OAI V2 specification
  (http://www.openarchives.org/OAI/openarchivesprotocol.html)

`oai` is built on `xml2` and `httr`. In addition, we give back
data.frame's whenever possible to make data comprehension,
manipulation, and visualization easier. We also have functions to
fetch a large directory of OAI-PMH services - it isn't exhaustive, but
does contain a lot.

OAI-PMH instead of paging with e.g., `page` and `per_page` parameters,
uses (optionally) `resumptionTokens`, optionally with an expiration
date. These tokens can be used to continue on to the next chunk of
data, if the first request did not get to the end. Often, OAI-PMH
services limit each request to 50 records, but this may vary by
provider, I don't know for sure. The API of this package is such that
we `while` loop for you internally until we get all records. We may in
the future expose e.g., a `limit` parameter so you can say how many
records you want, but we haven't done this yet.

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=b350aeeb7cea0c0a3aa12b1e15efe868f4c0c675

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

diffstat:
 Makefile       |  1 +
 R-oai/DESCR    |  7 +++++++
 R-oai/Makefile | 20 ++++++++++++++++++++
 R-oai/distinfo |  6 ++++++
 4 files changed, 34 insertions(+)

diffs:
diff --git a/Makefile b/Makefile
index 1e71952adc..1ad7db1de4 100644
--- a/Makefile
+++ b/Makefile
@@ -62,6 +62,7 @@ SUBDIR+=	R-mclust
 SUBDIR+=	R-mpfr
 SUBDIR+=	R-np
 SUBDIR+=	R-npsurv
+SUBDIR+=	R-oai
 SUBDIR+=	R-optparse
 SUBDIR+=	R-png
 SUBDIR+=	R-rgdal
diff --git a/R-oai/DESCR b/R-oai/DESCR
new file mode 100644
index 0000000000..66f4f71e5f
--- /dev/null
+++ b/R-oai/DESCR
@@ -0,0 +1,7 @@
+A general purpose client to work with any 'OAI-PMH' (Open Archives
+Initiative Protocol for 'Metadata' Harvesting) service. The 'OAI-PMH'
+protocol is described at
+<http://www.openarchives.org/OAI/openarchivesprotocol.html>. Functions
+are provided to work with the 'OAI-PMH' verbs: 'GetRecord',
+'Identify', 'ListIdentifiers', 'ListMetadataFormats', 'ListRecords',
+and 'ListSets'.
diff --git a/R-oai/Makefile b/R-oai/Makefile
new file mode 100644
index 0000000000..27e31ffdf6
--- /dev/null
+++ b/R-oai/Makefile
@@ -0,0 +1,20 @@
+# $NetBSD$
+
+R_PKGNAME=	oai
+R_PKGVER=	0.3.2
+CATEGORIES=	www
+
+MAINTAINER=	pkgsrc-users%NetBSD.org@localhost
+COMMENT=	General purpose 'Oai-PMH' services client
+LICENSE=	mit
+
+DEPENDS+=	R-plyr>=1.8.4:../../math/R-plyr
+DEPENDS+=	R-tibble>=1.2:../../math/R-tibble
+DEPENDS+=	R-stringr>=1.1.0:../../textproc/R-stringr
+DEPENDS+=	R-xml2>=1.0.0:../../textproc/R-xml2
+DEPENDS+=	R-httr>=1.2.0:../../www/R-httr
+
+USE_LANGUAGES=	# none
+
+.include "../../math/R/Makefile.extension"
+.include "../../mk/bsd.pkg.mk"
diff --git a/R-oai/distinfo b/R-oai/distinfo
new file mode 100644
index 0000000000..67e7402a4c
--- /dev/null
+++ b/R-oai/distinfo
@@ -0,0 +1,6 @@
+$NetBSD$
+
+SHA1 (R/oai_0.3.2.tar.gz) = 1117c73c64fa478ee1c129772d6493404e7e5cb9
+RMD160 (R/oai_0.3.2.tar.gz) = ad82171dcb0900768e085ef6ac0cf71ee10f8c20
+SHA512 (R/oai_0.3.2.tar.gz) = a5e3b2f177df08c2bca5db9ca9bd956eb8ec61ceccc8e88cd8a0f5fbe78805c93c91a66594662f50f89478c644198b1587da92d12564edfc7ddfdd64879a0415
+Size (R/oai_0.3.2.tar.gz) = 132840 bytes