[![Travis-CI Build Status](https://travis-ci.org/hrbrmstr/htmltidy.svg?branch=master)](https://travis-ci.org/hrbrmstr/htmltidy) [![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/hrbrmstr/htmltidy?branch=master&svg=true)](https://ci.appveyor.com/project/hrbrmstr/htmltidy) [![CRAN\_Status\_Badge](http://www.r-pkg.org/badges/version/htmltidy)](https://cran.r-project.org/package=htmltidy) ![downloads](http://cranlogs.r-pkg.org/badges/grand-total/htmltidy) # htmltidy Tidy Up and Test XPath Queries on HTML and XML Content ## Description Partly inspired by [this SO question](http://stackoverflow.com/questions/37061873/identify-a-weblink-in-bold-in-r) and because there’s a great deal of cruddy HTML out there that needs fixing to use properly when scraping data. It relies on a locally included version of [`libtidy`](http://www.html-tidy.org/) and works on macOS, Linux & Windows. It also incorporates an `htmlwidget` to view and test XPath queries on HTML/XML content and another widget to view an XML document in a collapseable tree view. ## What’s inside the tin? The following functions are implemented: - `tidy_html`: Tidy or “Pretty Print” HTML/XHTML Documents - `html_view`: HTML/XML pretty printer and viewer - `xml_view`: HTML/XML pretty printer and viewer - `html_tree_view`: HTML/XML tree viewer - `xml_tree_view`: HTML/XML tree viewer ## Installation ``` r devtools::install_github("hrbrmstr/htmltidy") ``` ## Usage ``` r library(htmltidy) # current verison packageVersion("htmltidy") ## [1] '0.5.0' library(XML) library(xml2) library(httr) library(purrr) ``` This is really “un-tidy” content: ``` r res <- GET("https://rud.is/test/untidy.html") cat(content(res, as="text")) ## ## ## ## ## This is some really poorly formatted HTML ## ## as is this portion
``` Let’s see what `tidy_html()` does to it. It can handle the `response` object directly: ``` r cat(tidy_html(res, list(TidyDocType="html5", TidyWrapLen=200))) ## ## ## ## ## ## ## ## ## This is some really poorly formatted HTML as is this ## portion ##
## ## ``` But, you’ll probably mostly use it on HTML you’ve identified as gnarly and already have that HTML text content handy: ``` r cat(tidy_html(content(res, as="text"), list(TidyDocType="html5", TidyWrapLen=200))) ## ## ## ## ## ## ## ## ## This is some really poorly formatted HTML as is this portion ##
## ## ``` NOTE: you could also just have done: ``` r cat(tidy_html(url("https://rud.is/test/untidy.html"), list(TidyDocType="html5", TidyWrapLen=200))) ## ## ## ## ## ## ## ## ## This is some really poorly formatted HTMLas is this portion ##
## ## ``` You’ll see that this differs substantially from the mangling `libxml2` does (via `read_html()`): ``` r pg <- read_html("https://rud.is/test/untidy.html") cat(toString(pg)) ## ## ## ## ## ## ## ## This is some really poorly formatted HTML ## ## as is this portion
## ## ``` It can also deal with “raw” and parsed objects: ``` r tidy_html(content(res, as="raw")) ## [1] 3c 21 44 4f 43 54 59 50 45 20 68 74 6d 6c 3e 0a 3c 68 74 6d 6c 20 78 6d 6c 6e 73 3d 22 68 74 74 70 3a 2f 2f 77 77 ## [39] 77 2e 77 33 2e 6f 72 67 2f 31 39 39 39 2f 78 68 74 6d 6c 22 3e 0a 3c 68 65 61 64 3e 0a 3c 6d 65 74 61 20 6e 61 6d ## [77] 65 3d 22 67 65 6e 65 72 61 74 6f 72 22 20 63 6f 6e 74 65 6e 74 3d 0a 22 48 54 4d 4c 20 54 69 64 79 20 66 6f 72 20 ## [115] 48 54 4d 4c 35 20 66 6f 72 20 52 20 76 65 72 73 69 6f 6e 20 35 2e 30 2e 30 22 20 2f 3e 0a 3c 74 69 74 6c 65 3e 3c ## [153] 2f 74 69 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f 64 79 3e 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c 3e ## [191] 0a tidy_html(content(res, as="text", encoding="UTF-8")) ## [1] "\n\n\n\n\n\n\n\nThis is some really poorly formatted HTML as is this\nportion\n
\n\n\n" tidy_html(content(res, as="parsed", encoding="UTF-8")) ## {xml_document} ## ## [1] \n\nportion
\n
## ## ## ## ## ## ##

https://rud.is/test/untidy.html

## ## ## ``` And, show the markup errors: ``` r invisible(tidy_html(url("https://rud.is/test/untidy.html"), verbose=TRUE)) ## line 1 column 1 - Warning: missing declaration ## line 1 column 68 - Warning: nested emphasis ## line 1 column 138 - Warning: missing before
## line 1 column 68 - Warning: missing before
## line 1 column 164 - Warning: inserting implicit ## line 1 column 164 - Warning: missing ## line 1 column 159 - Warning: missing
## line 1 column 1 - Warning: inserting missing 'title' element ## line 1 column 164 - Warning: anchor "sp" already defined ## Info: Document content looks like XHTML5 ## Tidy found 9 warnings and 0 errors! ``` ## Testing Options ``` r opts <- list(TidyDocType="html5", TidyMakeClean=TRUE, TidyHideComments=TRUE, TidyIndentContent=FALSE, TidyWrapLen=200) txt <- "

Test

" cat(tidy_html(txt, option=opts)) ## ## ## ## ## ## ## ## ##

Test

## ## ``` But, you’re probably better off running it on plain HTML source. Since it’s C/C++-backed, it’s pretty fast: ``` r book <- readLines("http://singlepageappbook.com/single-page.html") sum(map_int(book, nchar)) ## [1] 207501 system.time(tidy_book <- tidy_html(book)) ## user system elapsed ## 0.026 0.001 0.027 ``` (It’s usually between 20 & 25 milliseconds to process those 202 kilobytes of HTML.) Not too shabby. ## htmltidy Metrics | Lang | \# Files | (%) | LoC | (%) | Blank lines | (%) | \# Lines | (%) | | :----------- | -------: | ---: | ----: | ---: | ----------: | ---: | -------: | ---: | | C | 27 | 0.34 | 28646 | 0.81 | 4696 | 0.77 | 4304 | 0.59 | | C/C++ Header | 37 | 0.47 | 5799 | 0.16 | 1227 | 0.20 | 2674 | 0.36 | | C++ | 4 | 0.05 | 647 | 0.02 | 117 | 0.02 | 64 | 0.01 | | R | 10 | 0.13 | 151 | 0.00 | 38 | 0.01 | 235 | 0.03 | | Rmd | 1 | 0.01 | 53 | 0.00 | 51 | 0.01 | 68 | 0.01 | ## Code of Conduct Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md). By participating in this project you agree to abide by its terms.