Blog #3 - Recap

class: center, middle, inverse, title-slide

.title[
# Blog #3 - Recap
]
.author[
### Heike Hofmann
]

---

# How did it go?

So many errors!

- Drowning, Breaking Backs

- ... it's a process

- Experience

- Adventure

---

# Issues with building the book

0. Old versions ... of R, RStudio, tinytex, ...

1. Tons of packages to install ...

2. Changes in the way that R is working ...

3. Missing fonts

4. Some issues with the source code in the repo

---

# Old versions of ... stuff

For long stretches of time (months, years), the versions we use of <insert your package and software of choice here> do not matter.

and then we run into 'strange occurrences' ... when strange things happen, and ..

- you can not identify any good reasons of why
- nobody else seems to have a problem with it

Try to set an internal alarm to try solving your issues by updating your software.

---

# Changes in the way that R is working ...

This is not going to happen that often

While it is inconvenient now, try to think of it as a priviledge of having seen this rare occurrence

---

# Missing Fonts

Installation of fonts is platform-dependent, but ... you should know how a font is installed on your system

Inconsolata is a Google font: https://fonts.google.com/specimen/Inconsolata

The download comes with a README.txt file and instructions for installation

Installing fonts

- MacOS: https://support.apple.com/en-us/HT201749
    - Linux: https://www.google.com/search?q=how+to+install+a+font+on+gnu%2Blinux
    - Windows: https://support.microsoft.com/en-us/help/314960/how-to-install-or-remove-a-font-in-windows

---

# All those package installations

... are annoying 😠, tedious 😞,

would be so much easier if

- we could install them in one go 🐎

- we knew where we can access these packages (`emo` is not on CRAN) 😢

<br>
<br>
... there's a package for this ...

and  a file format for that! ![](images/pea-pot.png)
 
 <br>
 (`pea pot` emoji, released in 2022, not available in R yet)

---

# File Format `DESCRIPTION` and package `desc`

There is a `DESCRIPTION` file in https://github.com/hadley/adv-r

https://r-pkgs.org/description.html

R package `desc`:  tools to read, write, create, and manipulate `DESCRIPTION` files

Install as `remotes::install_github("r-lib/desc")`

https://r-lib.github.io/desc/

Meant for package development - also great for easing the reproducible workflow

---

# Package `desc` in action

```r
library(desc)
download.file(url="https://raw.githubusercontent.com/hadley/adv-r/master/DESCRIPTION", destfile = "DESCRIPTION")
desc_get_deps(file="DESCRIPTION") |> DT::datatable(options = list(pageLength = 5))
```

<div class="datatables html-widget html-fill-item-overflow-hidden html-fill-item" id="htmlwidget-306e63272925051b890f" style="width:100%;height:auto;"></div>
<script type="application/json" data-for="htmlwidget-306e63272925051b890f">{"x":{"filter":"none","vertical":false,"data":[["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"],["Depends","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Imports","Suggests","Suggests","Suggests","Suggests","Suggests","Suggests","Suggests","Suggests","Suggests"],["R","bench","dbplyr","emo","ggbeeswarm","ggplot2","lobstr","memoise","profvis","Rcpp","rlang","RSQLite","scales","sloop","testthat","tidyr","vctrs","zeallot","bslib","downlit","bookdown","desc","jsonlite","knitr","png","sessioninfo","xml2"],[">= 3.1.0","*","*","*","*","*","*","*","*","*",">= 0.3.0","*",">= 1.0.0","*","*","*","*","*","*","*","*","*","*","*","*","*","*"]],"container":"<table class=\"display\">\n  <thead>\n    <tr>\n      <th> <\/th>\n      <th>type<\/th>\n      <th>package<\/th>\n      <th>version<\/th>\n    <\/tr>\n  <\/thead>\n<\/table>","options":{"pageLength":5,"columnDefs":[{"orderable":false,"targets":0}],"order":[],"autoWidth":false,"orderClasses":false,"lengthMenu":[5,10,25,50,100]}},"evals":[],"jsHooks":[]}</script>
---

# DESCRIPTION field Remotes

contains (very concise) installation instructions for packages that are not on CRAN, or packages for which a development version of CRAN should be used

```r
desc::desc_get("Remotes", file="DESCRIPTION-AdvR") |> cat()
```

```
## 
##     hadley/emo,
##     rstudio/bookdown,
##     rstudio/bslib,
##     rstudio/rmarkdown
```

Entries are of the form <github handle>/<repo name> and are installed 
using the command `remotes::install_github("<github handle>/<repo name>")`

Non github remote dependencies need to be specified with `::`, i.e. for example `bitbucket::<handle>/<repo>`.

Other resources are e.g. git, gitlab, bioconductor, svn, local repos, or general urls.

See also: https://remotes.r-lib.org/articles/dependencies.html#other-sources

---
class: center, inverse, middle

# Well done!

---
class: center, inverse, middle

# Don't forget to READ the book now 😁

---

## Blog 4

Help with `dplyr`: [R for Data Science](https://r4ds.had.co.nz/)

---

## This Thursday: lab

The next lab is scheduled for Feb 16 (this Thursday), please fill out the survey on how you want to attend ... I'll randomly assign groups within modality

We will do some web-scraping to read data that might not have been meant to be read by us :)

- list objects, matrices and a bit of functions