Skip to content

Commit

Permalink
Make pkgdown happy.
Browse files Browse the repository at this point in the history
  • Loading branch information
jonthegeek committed Sep 4, 2024
1 parent e59bebd commit 1644e8c
Show file tree
Hide file tree
Showing 12 changed files with 168 additions and 38 deletions.
124 changes: 124 additions & 0 deletions README.Rmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

# tidytuesdayR <a href="https://dslc-io.github.io/tidytuesdayR/"><img src="man/figures/logo.png" align="right" height="138" alt="tidytuesdayR website" /></a>

<!-- badges: start -->
[![CRAN status](https://www.r-pkg.org/badges/version/tidytuesdayR)](https://CRAN.R-project.org/package=tidytuesdayR)
[![R build status](https://github.com/dslc-io/tidytuesdayR/workflows/R-CMD-check/badge.svg)](https://github.com/dslc-io/tidytuesdayR/actions)
[![Coverage
status](https://codecov.io/gh/dslc-io/tidytuesdayR/branch/main/graph/badge.svg)](https://app.codecov.io/github/dslc-io/tidytuesdayR?branch=main)
[![Downloads from the RStudio CRAN mirror](http://cranlogs.r-pkg.org/badges/tidytuesdayR)](https://cran.r-project.org/package=tidytuesdayR)
[![License:
MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![R-CMD-check](https://github.com/dslc-io/tidytuesdayR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dslc-io/tidytuesdayR/actions/workflows/R-CMD-check.yaml)
<!-- badges: end -->

tidytuesdayR makes it easy to participate in the weekly [\#TidyTuesday](https://tidytues.day/) project by providing functions to quickly import data posted to the [Tidy Tuesday repository](https://github.com/rfordatascience/tidytuesday).

## Installation

This package is (usually) available on CRAN via:

``` r
install.packages("tidytuesdayR")
```

To get the latest in-development features, install the development version from GitHub:

``` r
#install.packages("pak")
pak::pak("dslc-io/tidytuesdayR")
```

## Usage

There are currently two methods to access the data from the respository.

### Load the Data!

The simplest way is to use the `tt_load()` function. This
function has accepts two types of inputs to determine which data to
grab. It can be a date as a string in the YYYY-MM-DD format like below.

``` r
library(tidytuesdayR)
tt_data <- tt_load("2019-01-15")
```

Or the function can accept the year as the first argument, and which
week of the year as the second.

``` r
tt_data <- tt_load(2019, week=3)
```

`tt_load()` naively downloads *all* the data that is available and
stores them in the resulting `tt_data` object. To access the data, use
the `$` or `[[` notation and the name of the dataset.

``` r
tt_data$agencies
tt_data[["agencies"]]
```

To view the readme, either print the `tt_data` object or use the `readme()`
function. When you print the `tt_data` object, you also get the available
datasets names printed in the console.

``` r
readme(tt_data)
print(tt_data)
```

```
## Available Datasets:
## agencies
## launches
##
```

### TidyTemplate

As part of the goal of making participating in #TidyTuesday easier, {tidytuesdayR} now also provides a template!
To use it, just use the `use_tidytemplate()` function!

By default, the template will assume to be using the most recent TidyTuesday.
However, you can pass a date object or character string in YYYY-MM-DD format
defining a different date you want to use. If you don't recall the exact date,
no worries, you can use the `tt_available()` function to figure out which date
and get the date to use!

```r
## this weeks TidyTuesday!
tidytuesdayR::use_tidytemplate()

## TidyTuesday from Week 42 of 2019
tidytuesdayR::use_tidytemplate(refdate = "2019-10-15")
```

Additionally, by default the template will create the new file in your working
directory, using the "YYYY_MM_DD" format per good practices.
However, if you are so inclined, you can rename it to whatever you wish.

```r
tidytuesdayR::use_tidytemplate(name = "My Super Great TidyTuesday.Rmd")
```

## Contributing

Please note that the ‘tidytuesdayR’ project is released with a
[Contributor Code of Conduct](CODE_OF_CONDUCT.md). By contributing to
this project, you agree to abide by its terms.
5 changes: 3 additions & 2 deletions _pkgdown.yml
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
url: https://dslc-io.github.io/tidytuesdayR/

template:
params:
bootswatch: cosmo
bootstrap: 5
Binary file modified man/figures/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon-120x120.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon-152x152.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon-180x180.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon-60x60.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon-76x76.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/apple-touch-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/favicon-16x16.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified pkgdown/favicon/favicon-32x32.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
77 changes: 41 additions & 36 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,38 @@
# tidytuesdayR <img src="man/figures/logo.png" align="right" height=140/>

<!-- README.md is generated from README.Rmd. Please edit that file -->

# tidytuesdayR <a href="https://dslc-io.github.io/tidytuesdayR/"><img src="man/figures/logo.png" align="right" height="138" alt="tidytuesdayR website" /></a>

<!-- badges: start -->
[![CRAN status](https://www.r-pkg.org/badges/version/tidytuesdayR)](https://CRAN.R-project.org/package=tidytuesdayR)
[![R build status](https://github.com/dslc-io/tidytuesdayR/workflows/R-CMD-check/badge.svg)](https://github.com/dslc-io/tidytuesdayR/actions)

[![CRAN
status](https://www.r-pkg.org/badges/version/tidytuesdayR)](https://CRAN.R-project.org/package=tidytuesdayR)
[![R build
status](https://github.com/dslc-io/tidytuesdayR/workflows/R-CMD-check/badge.svg)](https://github.com/dslc-io/tidytuesdayR/actions)
[![Coverage
status](https://codecov.io/gh/dslc-io/tidytuesdayR/branch/main/graph/badge.svg)](https://app.codecov.io/github/dslc-io/tidytuesdayR?branch=main)
[![Downloads from the RStudio CRAN mirror](http://cranlogs.r-pkg.org/badges/tidytuesdayR)](https://cran.r-project.org/package=tidytuesdayR)
[![Downloads from the RStudio CRAN
mirror](http://cranlogs.r-pkg.org/badges/tidytuesdayR)](https://cran.r-project.org/package=tidytuesdayR)
[![License:
MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![R-CMD-check](https://github.com/dslc-io/tidytuesdayR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/dslc-io/tidytuesdayR/actions/workflows/R-CMD-check.yaml)
<!-- badges: end -->

{tidytuesdayR} has the main goal to make it easy to participate in the
weekly [\#TidyTuesday](https://github.com/rfordatascience/tidytuesday)
project. Currently this is done by assisting with the import of data
posted on the [R4DataScience](https://github.com/rfordatascience) Tidy
Tuesday repository.
tidytuesdayR makes it easy to participate in the weekly
[\#TidyTuesday](https://tidytues.day/) project by providing functions to
quickly import data posted to the [Tidy Tuesday
repository](https://github.com/rfordatascience/tidytuesday).

## Installation

This package is available on CRAN via:
This package is (usually) available on CRAN via:

``` r
install.packages("tidytuesdayR")
```

To get the latest in-development features, install the development version from GitHub:
To get the latest in-development features, install the development
version from GitHub:

``` r
#install.packages("pak")
Expand All @@ -38,9 +45,9 @@ There are currently two methods to access the data from the respository.

### Load the Data!

The simplest way is to use the ‘tt\_load()’ function. This
function has accepts two types of inputs to determine which data to
grab. It can be a date as a string in the YYYY-MM-DD format like below.
The simplest way is to use the `tt_load()` function. This function has
accepts two types of inputs to determine which data to grab. It can be a
date as a string in the YYYY-MM-DD format like below.

``` r
library(tidytuesdayR)
Expand All @@ -63,51 +70,49 @@ tt_data$agencies
tt_data[["agencies"]]
```

To view the readme, either print the `tt_data` object or use the `readme()`
function. When you print the `tt_data` object, you also get the available
datasets names printed in the console.
To view the readme, either print the `tt_data` object or use the
`readme()` function. When you print the `tt_data` object, you also get
the available datasets names printed in the console.

``` r
readme(tt_data)
print(tt_data)
```

```
## Available Datasets:
## agencies
## launches
##
```
## Available Datasets:
## agencies
## launches
##

### TidyTemplate

As part of the goal of making participating in #TidyTuesday easier, {tidytuesdayR} now also provides a template!
To use it, just use the `use_tidytemplate()` function!
As part of the goal of making participating in \#TidyTuesday easier,
{tidytuesdayR} now also provides a template! To use it, just use the
`use_tidytemplate()` function!

By default, the template will assume to be using the most recent TidyTuesday.
However, you can pass a date object or character string in YYYY-MM-DD format
defining a different date you want to use. If you don't recall the exact date,
no worries, you can use the `tt_available()` function to figure out which date
and get the date to use!
By default, the template will assume to be using the most recent
TidyTuesday. However, you can pass a date object or character string in
YYYY-MM-DD format defining a different date you want to use. If you
don’t recall the exact date, no worries, you can use the
`tt_available()` function to figure out which date and get the date to
use!

```r
``` r
## this weeks TidyTuesday!
tidytuesdayR::use_tidytemplate()

## TidyTuesday from Week 42 of 2019
tidytuesdayR::use_tidytemplate(refdate = "2019-10-15")
```

Additionally, by default the template will create the new file in your working
directory, using the "YYYY_MM_DD" format per good practices.
Additionally, by default the template will create the new file in your
working directory, using the YYYY_MM_DD format per good practices.
However, if you are so inclined, you can rename it to whatever you wish.

```r
``` r
tidytuesdayR::use_tidytemplate(name = "My Super Great TidyTuesday.Rmd")
```



## Contributing

Please note that the ‘tidytuesdayR’ project is released with a
Expand Down

0 comments on commit 1644e8c

Please sign in to comment.