~hrbrmstr/playdoh

cda06176bb2626c26f9e20881df13246d1c51818 — boB Rudis 1 year, 2 months ago cf3da3e
add RFC
7 files changed, 25 insertions(+), 14 deletions(-)

M DESCRIPTION
M R/doh-post.R
M R/playdoh-package.R
M README.Rmd
M README.md
M man/doh_post.Rd
M man/playdoh.Rd
M DESCRIPTION => DESCRIPTION +1 -1
@@ 8,7 8,7 @@ Authors@R: c(
           comment = c(ORCID = "0000-0001-5670-2640"))
  )
Maintainer: Bob Rudis <bob@rud.is>
Description: Make 'DNS over HTTPS' queries.
Description: Make 'DNS over HTTPS' (<https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html>) queries.
URL: https://gitlab.com/hrbrmstr/playdoh
BugReports: https://gitlab.com/hrbrmstr/playdoh/issues
Encoding: UTF-8

M R/doh-post.R => R/doh-post.R +1 -0
@@ 6,6 6,7 @@
#' @param type DNS query type (defaults to "`A`")
#' @param server_path full URL path to the DoH server quer endpoint (defaults to Quad9).
#' @return `NULL` (if the query failed) or a `data.frame` (tibble)
#' @references <https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html>
#' @export
doh_post <- function(name, type = "A", server_path = "https://dns.quad9.net/dns-query") {


M R/playdoh-package.R => R/playdoh-package.R +1 -0
@@ 1,5 1,6 @@
#' Make 'DNS over HTTPS' Queries
#'
#' - RFC: <https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html>
#' - URL: <https://gitlab.com/hrbrmstr/playdoh>
#' - BugReports: <https://gitlab.com/hrbrmstr/playdoh/issues>
#'

M README.Rmd => README.Rmd +2 -0
@@ 20,6 20,8 @@ Make 'DNS over HTTPS' Queries

Make 'DNS over HTTPS' Queries

DoH RTFM: <https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html>

## What's Inside The Tin

The following functions are implemented:

M README.md => README.md +16 -13
@@ 13,6 13,9 @@ Make ‘DNS over HTTPS’ Queries

Make ‘DNS over HTTPS’ Queries

DoH RTFM:
<https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html>

## What’s Inside The Tin

The following functions are implemented:


@@ 47,30 50,30 @@ doh_post("rud.is")
## # A tibble: 1 x 6
##   query   qtype rname   rtype rdata           ttl
##   <chr>   <int> <chr>   <int> <chr>         <int>
## 1 rud.is.     1 rud.is.     1 172.93.49.183  3572
## 1 rud.is.     1 rud.is.     1 172.93.49.183  3600

doh_post("lenovo.com", "txt")
## # A tibble: 10 x 6
##    query      qtype rname      rtype rdata                                                                           ttl
##    <chr>      <int> <chr>      <int> <chr>                                                                         <int>
##  1 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=nGgukcp60rC-gFxMOJw1NHH0B4VnSchRrlfWV-He_tE\""     7173
##  2 lenovo.co…    16 lenovo.co…    16 "\"a82c74b37aa84e7c8580f0e32f4d795d\""                                         7173
##  3 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=sHIlSlj0U6UnCDkfHp1AolWgVEvDjWvc0TR4KaysD2c\""     7173
##  4 lenovo.co…    16 lenovo.co…    16 "\"v=spf1 include:spf.messagelabs.com include:_netblocks.eloqua.com ~all\""    7173
##  5 lenovo.co…    16 lenovo.co…    16 "\"qh7hdmqm4lzs85p704d6wsybgrpsly0j\""                                         7173
##  6 lenovo.co…    16 lenovo.co…    16 "\"ece42d7743c84d6889abda7011fe6f53\""                                         7173
##  7 lenovo.co…    16 lenovo.co…    16 "\"iHzQJvsKnyGP2Nm2qBgL3fyBJ0CC9z4GkY/flfk4EzLP8lPxWHDDPKqZWm1TkeF5kEIL+NotY…  7173
##  8 lenovo.co…    16 lenovo.co…    16 "\"Visit www.lenovo.com/think for information about Lenovo products and serv…  7173
##  9 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=VxW_e6r_Ka7A518qfX2MmIMHGnkpGbnACsjSxKFCBw0\""     7173
## 10 lenovo.co…    16 lenovo.co…    16 "\"facebook-domain-verification=1r2am7c2bhzrxpqyt0mda0djoquqsi\""              7173
##  1 lenovo.co…    16 lenovo.co…    16 "\"qh7hdmqm4lzs85p704d6wsybgrpsly0j\""                                            1
##  2 lenovo.co…    16 lenovo.co…    16 "\"ece42d7743c84d6889abda7011fe6f53\""                                            1
##  3 lenovo.co…    16 lenovo.co…    16 "\"a82c74b37aa84e7c8580f0e32f4d795d\""                                            1
##  4 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=VxW_e6r_Ka7A518qfX2MmIMHGnkpGbnACsjSxKFCBw0\""        1
##  5 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=sHIlSlj0U6UnCDkfHp1AolWgVEvDjWvc0TR4KaysD2c\""        1
##  6 lenovo.co…    16 lenovo.co…    16 "\"Visit www.lenovo.com/think for information about Lenovo products and serv…     1
##  7 lenovo.co…    16 lenovo.co…    16 "\"google-site-verification=nGgukcp60rC-gFxMOJw1NHH0B4VnSchRrlfWV-He_tE\""        1
##  8 lenovo.co…    16 lenovo.co…    16 "\"iHzQJvsKnyGP2Nm2qBgL3fyBJ0CC9z4GkY/flfk4EzLP8lPxWHDDPKqZWm1TkeF5kEIL+NotY…     1
##  9 lenovo.co…    16 lenovo.co…    16 "\"v=spf1 include:spf.messagelabs.com include:_netblocks.eloqua.com ~all\""       1
## 10 lenovo.co…    16 lenovo.co…    16 "\"facebook-domain-verification=1r2am7c2bhzrxpqyt0mda0djoquqsi\""                 1
```

## playdoh Metrics

| Lang | \# Files |  (%) | LoC |  (%) | Blank lines |  (%) | \# Lines |  (%) |
| :--- | -------: | ---: | --: | ---: | ----------: | ---: | -------: | ---: |
| R    |        6 | 0.86 | 122 | 0.92 |          23 | 0.52 |       26 | 0.43 |
| Rmd  |        1 | 0.14 |  11 | 0.08 |          21 | 0.48 |       35 | 0.57 |
| R    |        6 | 0.86 | 122 | 0.92 |          23 | 0.51 |       26 | 0.42 |
| Rmd  |        1 | 0.14 |  11 | 0.08 |          22 | 0.49 |       36 | 0.58 |

## Code of Conduct


M man/doh_post.Rd => man/doh_post.Rd +3 -0
@@ 20,3 20,6 @@ doh_post(name, type = "A",
\description{
Issue the query of type \code{type} for \code{name} to the DoH endpoint specified at \code{server_path}.
}
\references{
\url{https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html}
}

M man/playdoh.Rd => man/playdoh.Rd +1 -0
@@ 7,6 7,7 @@
\title{Make 'DNS over HTTPS' Queries}
\description{
\itemize{
\item RFC: \url{https://tools.ietf.org/id/draft-ietf-doh-dns-over-https-05.html}
\item URL: \url{https://gitlab.com/hrbrmstr/playdoh}
\item BugReports: \url{https://gitlab.com/hrbrmstr/playdoh/issues}
}