{"id":14067905,"url":"https://github.com/hrbrmstr/gdns","last_synced_at":"2025-10-29T01:30:43.244Z","repository":{"id":141238205,"uuid":"55867299","full_name":"hrbrmstr/gdns","owner":"hrbrmstr","description":"Tools to work with the Google DNS over HTTPS API in R","archived":false,"fork":false,"pushed_at":"2020-05-15T12:06:46.000Z","size":105,"stargazers_count":26,"open_issues_count":0,"forks_count":9,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-02-01T20:51:12.657Z","etag":null,"topics":["dns","google-dns","r","r-cyber","rstats","spf-record"],"latest_commit_sha":null,"homepage":"https://cinc.rud.is/web/packages/gdns/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hrbrmstr.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2016-04-09T21:15:21.000Z","updated_at":"2025-01-28T02:36:34.000Z","dependencies_parsed_at":"2024-02-19T19:16:45.387Z","dependency_job_id":"54b78702-2ee9-4ff2-acc2-ed1dd2a9c0b5","html_url":"https://github.com/hrbrmstr/gdns","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hrbrmstr%2Fgdns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hrbrmstr%2Fgdns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hrbrmstr%2Fgdns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hrbrmstr%2Fgdns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hrbrmstr","download_url":"https://codeload.github.com/hrbrmstr/gdns/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238752267,"owners_count":19524733,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dns","google-dns","r","r-cyber","rstats","spf-record"],"created_at":"2024-08-13T07:05:50.327Z","updated_at":"2025-10-29T01:30:37.962Z","avatar_url":"https://github.com/hrbrmstr.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"---\noutput: rmarkdown::github_document\neditor_options: \n  chunk_output_type: console\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r include=FALSE}\nknitr::opts_chunk$set(\n  message = FALSE,\n  warning = FALSE,\n  fig.retina = 2\n)\noptions(width=120)\n```\n\n[![Travis-CI Build Status](https://travis-ci.org/hrbrmstr/gdns.svg?branch=master)](https://travis-ci.org/hrbrmstr/gdns)\n\n# gdns\n\nTools to work with the Google DNS over HTTPS (DoH) API\n\n## Description\n\nTraditional DNS queries and responses are sent over UDP or TCP without encryption. This is vulnerable to eavesdropping and spoofing (including DNS-based Internet filtering). Responses from recursive resolvers to clients are the most vulnerable to undesired or malicious changes, while communications between recursive resolvers and authoritative nameservers often incorporate additional protection.\n\nTo address this problem, Google Public DNS offers DNS resolution over an encrypted HTTPS connection. DNS-over-HTTPS greatly enhances privacy and security between a client and a recursive resolver, and complements DNSSEC to provide end-to-end authenticated DNS lookups.\n\nMore info at \u003chttps://developers.google.com/speed/public-dns/docs/doh/\u003e.\n\nThe following functions are implemented:\n\nCore: \n\n- `query` / `dig`:\tPerform DNS over HTTPS queries using Google\n- `bulk_query`:\tVectorized query, returning only answers in a data frame\n- `as.data.frame`: Coerce a gdns query response answer to a data frame\n\nHelpers:\n\n- `has_spf`:\tTest for whether a DNS TXT record is an SPF record\n- `is_hard_fail`:\tSPF \"all\" type test\n- `is_soft_fail`:\tSPF \"all\" type test\n- `passes_all`:\tSPF \"all\" type test\n- `spf_exists`:\tSPF field extraction functions\n- `spf_includes`:\tSPF field extraction functions\n- `spf_ipv4s`:\tSPF field extraction functions\n- `spf_ipv6s`:\tSPF field extraction functions\n- `spf_ptrs`:\tSPF field extraction functions\n- `split_spf`:\tSplit out all SPF records in a domain's TXT record\n\nIANA Datasets:\n\n- `dns_classes`: DNS CLASSes (dataset)\n- `dns_glob_names`:  Underscored and Globally Scoped DNS Node Names (dataset)\n- `dns_opcodes`: DNS OpCodes (dataset)\n- `dns_rcodes`:  DNS RCODEs (dataset)\n- `edns0_option_codes`:  DNS EDNS0 Option Codes (OPT) (dataset)\n- `rrtypes`: Resource Record (RR) TYPEs (dataset)\n\n### Installation\n\nAny of the following:\n\n```{r eval=FALSE}\ninstall.packages(\"gdns\", repos = \"https://cinc.rud.is\")\ndevtools::install_git(\"https://git.rud.is/hrbrmstr/gdns\")\ndevtools::install_git(\"https://git.sr.ht/~rbrmstr/gdns\")\ndevtools::install_bitbucket(\"hrbrmstr/gdns\")\ndevtools::install_gitlab(\"hrbrmstr/gdns\")\ndevtools::install_github(\"hrbrmstr/gdns\")\n```\n\n```{r echo=FALSE, message=FALSE, warning=FALSE, error=FALSE}\noptions(width=120)\n```\n\n### Usage\n\n```{r}\nlibrary(gdns)\nlibrary(tibble) # for printing\n\n# current verison\npackageVersion(\"gdns\")\n\nstr(query(\"rud.is\"))\n\nquery(\"rud.is\") %\u003e% \n  as.data.frame()\n\nstr(dig(\"example.com\", \"255\")) # \"ANY\" query\n\nquery(\"microsoft.com\", \"MX\") %\u003e% \n  as.data.frame()\n\nas.data.frame(query(\"apple.com\"))\n\nas.data.frame(dig(\"17.142.160.59\", \"PTR\"))\n\nhosts \u003c- c(\"rud.is\", \"dds.ec\", \"r-project.org\", \"rstudio.com\", \"apple.com\")\n\ngdns::bulk_query(hosts)\n```\n\n## gdns Metrics\n\n```{r cloc, echo=FALSE}\ncloc::cloc_pkg_md()\n```\n\n## Code of Conduct\n\nPlease note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhrbrmstr%2Fgdns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhrbrmstr%2Fgdns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhrbrmstr%2Fgdns/lists"}