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
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# selectr
[](https://opensource.org/licenses/BSD-3-Clause) [](https://travis-ci.org/sjp/selectr) [](https://cran.r-project.org/package=selectr) [](https://codecov.io/gh/sjp/selectr) 
selectr is a package which makes working with HTML and XML documents easier. It does this by performing translation of CSS selectors into XPath expressions so that you can query `XML` and `xml2` documents easily.
``` r
library(selectr)
xpath <- css_to_xpath("#selectr")
xpath
#> [1] "descendant-or-self::*[@id = 'selectr']"
```
## Installation
### Install the release version from CRAN
``` r
install.packages("selectr")
```
### Install the development version from GitHub
``` r
# install.packages("devtools")
devtools::install_github("sjp/selectr")
```
## Overview
The key functions in selectr are:
* Translate a CSS selector into an XPath expression with `css_to_xpath()`.
* Query an `XML` or `xml2` document with `querySelector()` and its variants.
* Find the first matching node with `querySelector()`.
* Find all matching nodes with `querySelectorAll()`.
* Find the first matching node in a namespaced document with `querySelectorNS()`.
* Find all matching nodes in a namespaced document with `querySelectorAllNS()`.
## Examples
Here is a simple example to demonstrate how to query an `XML` or `xml2` document with `querySelector()`.
``` r
library(selectr)
xmlText <- '<foo><bar><baz id="first"/></bar><baz id="second"/></foo>'
library(XML)
doc <- xmlParse(xmlText)
querySelector(doc, "baz")
#> <baz id="first"/>
querySelectorAll(doc, "baz")
#> [[1]]
#> <baz id="first"/>
#>
#> [[2]]
#> <baz id="second"/>
#>
#> attr(,"class")
#> [1] "XMLNodeSet"
library(xml2)
doc <- read_xml(xmlText)
querySelector(doc, "baz")
#> {xml_node}
#> <baz id="first">
querySelectorAll(doc, "baz")
#> {xml_nodeset (2)}
#> [1] <baz id="first"/>
#> [2] <baz id="second"/>
```
|
