{"id":13399372,"url":"https://github.com/r-lib/actions","last_synced_at":"2025-05-14T14:10:16.723Z","repository":{"id":38443416,"uuid":"214215524","full_name":"r-lib/actions","owner":"r-lib","description":"GitHub Actions for the R community","archived":false,"fork":false,"pushed_at":"2025-04-29T13:30:04.000Z","size":35528,"stargazers_count":1002,"open_issues_count":18,"forks_count":224,"subscribers_count":15,"default_branch":"v2-branch","last_synced_at":"2025-04-29T14:42:02.226Z","etag":null,"topics":["github-actions","r"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/r-lib.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-10T15:13:37.000Z","updated_at":"2025-04-29T13:28:04.000Z","dependencies_parsed_at":"2023-10-20T22:43:58.097Z","dependency_job_id":"ac67584c-07b6-4f9d-b7a6-403a1a4d7c35","html_url":"https://github.com/r-lib/actions","commit_stats":{"total_commits":1143,"total_committers":148,"mean_commits":7.722972972972973,"dds":0.642169728783902,"last_synced_commit":"607b3ffaee2e0e54cacd36fab06ada0a120c8c0c"},"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-lib%2Factions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-lib%2Factions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-lib%2Factions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r-lib%2Factions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r-lib","download_url":"https://codeload.github.com/r-lib/actions/tar.gz/refs/heads/v2-branch","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160557,"owners_count":22024571,"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":["github-actions","r"],"created_at":"2024-07-30T19:00:36.963Z","updated_at":"2025-05-14T14:10:11.711Z","avatar_url":"https://github.com/r-lib.png","language":"TypeScript","funding_links":[],"categories":["JavaScript","TypeScript"],"sub_categories":[],"readme":"# GitHub Actions for the R language\n\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8907/badge)](https://www.bestpractices.dev/projects/8907)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/r-lib/actions/badge)](https://securityscorecards.dev/viewer/?uri=github.com/r-lib/actions)\n[![R build status](https://github.com/r-lib/actions/workflows/R-CMD-check/badge.svg)](https://github.com/r-lib/actions/actions?workflow=R-CMD-check)\n[![RStudio community](https://img.shields.io/badge/community-github--actions-blue?style=social\u0026logo=rstudio\u0026logoColor=75AADB)](https://community.rstudio.com/new-topic?category=Package%20development\u0026tags=github-actions)\n\nThis repository stores [GitHub Actions](https://github.com/features/actions)\nfor R projects, which can be used to do a variety of CI tasks. It also has a\nnumber of [example workflows](https://github.com/r-lib/actions/tree/v2/examples) which use\nthese actions.\n\n## Getting started\n\nSee [this blog post](https://www.tidyverse.org/blog/2022/06/actions-2-0-0/) on the Tidyverse blog.\n\n## Releases and tags\n\nWe use major version tags to mark breaking changes in these actions.\nFor the current version, please use the `v2` tag, e.g.:\n\n```yaml\n- uses: r-lib/actions/setup-r@v2\n```\n\nThe `v2` tag occasionally changes, to introduce non-breaking fixes and\nimprovements. These changes use more fine-grained tags, e.g. `v2.0.1`.\nYou can refer to these as well in your workflow files if you need to.\n\n## List of actions\n\n1. [r-lib/actions/setup-r](https://github.com/r-lib/actions/tree/v2/setup-r) - Sets up [R](https://r-project.org)\n1. [r-lib/actions/setup-r-dependencies](https://github.com/r-lib/actions/tree/v2/setup-r-dependencies) - Installs packages declared in `DESCRIPTION`\n1. [r-lib/actions/setup-renv](https://github.com/r-lib/actions/tree/v2/setup-renv) - Installs packages from renv lockfile\n1. [r-lib/actions/setup-pandoc](https://github.com/r-lib/actions/tree/v2/setup-pandoc) - Sets up [pandoc](https://pandoc.org/)\n1. [r-lib/actions/setup-tinytex](https://github.com/r-lib/actions/tree/v2/setup-tinytex) - Sets up LaTeX with [tinytex](https://yihui.name/tinytex)\n1. [r-lib/actions/check-r-package](https://github.com/r-lib/actions/tree/v2/check-r-package) - Runs `R CMD check` on an R package\n1. [r-lib/actions/pr-fetch](https://github.com/r-lib/actions/tree/v2/pr-fetch) - Fetches changes of a PR associated with an event\n1. [r-lib/actions/pr-push](https://github.com/r-lib/actions/tree/v2/pr-push) - Pushes changes to a PR associated with an event\n1. [r-lib/actions/setup-manifest](https://github.com/r-lib/actions/tree/v2/setup-manifest) - Sets up an R project with a Posit Connect `manifest.json` file\n\n## Other GitHub Actions for R projects\n\n* [quarto-dev/quarto-actions](https://github.com/quarto-dev/quarto-actions) - Quarto related actions: install, render, publish\n\n## What's new?\n\nSee the [`v2` release notes](https://github.com/r-lib/actions/releases/tag/v2).\nThese notes are kept current with the changes in `v2`.\n\n## Examples\n\nSee the [r-lib/actions/examples](https://github.com/r-lib/actions/tree/v2/examples) directory\nfor a variety of example workflows using these actions.\n\n## Where to find help\n\nIf your build fails, and you are unsure of why, here are some useful strategies for getting help.\n\n1. Figure out what caused the error. Look for the _first_ time the word\n   'error' appears in the build log. Quite often errors at the end of the log are caused\n   by an earlier issue, so it is best to look for the root cause.\n1. Take advantage of [GitHub's code search](https://github.com/search?q=path%3A.github%2Fworkflows) to find similar yaml files.\n   Use 'path:.github/workflows' to restrict your search to GitHub Action workflow files and also include additional terms specific to your problem.\n   e.g. If you need to figure out how to install geospatial libraries such as [gdal](https://gdal.org/), use a search like ['gdal path:.github/workflows'](https://github.com/search?q=gdal+path%3A.github%2Fworkflows).\n   If you want to restrict results only to GitHub Actions workflows that use R you can add search for ['\"setup-r\" path:.github/workflows](https://github.com/search?q=%22setup-r%22+path%3A.github%2Fworkflows)\n1. Open an issue on [![RStudio\n   community](https://img.shields.io/badge/community-github--actions-blue?style=social\u0026logo=rstudio\u0026logoColor=75AADB)](https://community.rstudio.com/new-topic?category=Package%20development\u0026tags=github-actions)\n   about your problem. Be sure to link to the workflow file you are using and a\n   failing build to help others help you.\n1. If your issue seems related to GitHub Actions, but is not specific to R, open an\n   issue at the [GitHub Actions\n   Community](https://github.community/t5/GitHub-Actions/bd-p/actions) page.\n1. If you have done all of the above and are __absolutely__ sure there is a bug\n   in one of the R specific actions listed above, check if there is an open issue\n   about it [in this repo](https://github.com/r-lib/actions/issues). Look at the\n   pinned issues at the top first! We pin issues that affect many people, and the\n   issue discussions often contain workarounds.\n1. Otherwise open a [new issue in this repo](https://github.com/r-lib/actions/issues/new/choose).\n\n\u003e If using a general search engine or GitHub search about your problem/idea, please note that content published prior to the Fall 2019 is probably outdated because the beta version of GitHub Actions was different. More recent posts or answers could be outdated too since GitHub Actions evolve, so refer to [GitHub Actions official docs](https://help.github.com/en/actions) in case of doubt (and to existing working workflows) and [GitHub changelog](https://github.blog/changelog/).\n\n## Contributions\n\nYour contributions are welcome! For new features, or if you are unsure\nabout a bug fix, please open issue before submitting a pull request.\nWhen submitting a pull request, please match the coding style of the\nexisting code. For any R code, please refer to the\n[Tidyverse style guide](https://style.tidyverse.org/).\nFor TypeScript and JavaScript code, you can run `npm run format`\nto standardize the code formatting.\nAdding a major feature also needs testing, typically by running a\nGHA workflow on the R package in this repository. Thank You!\n\n## Common questions\n\n1. *Why are my builds with plots failing on macOS?*\\\n\\\n  You need to install XQuartz to do plotting with the default quartz device on macOS. This can be done by adding the following to your workflow.\n    ```yaml\n    - if: runner.os == 'macOS'\n      run: brew install --cask xquartz\n    ```\n\n1. *Why are my Windows builds failing with an error about `configure.ac` having CRLF line endings?*\\\n\\\n  On Windows, when your repo is checked out using git, the line endings are automatically changed to CRLF. R's check process specifically checks if the `configure.ac` file has these line endings, and will error if it does. To avoid this, add a `.gitattributes` file to the top level of your package with the following to configure git to always use LF line endings for this file: \\\n  `configure.ac text eol=lf`\n\n1. *How can I customize an action to run R code?*\\\n\\\nThe safest way is to add a `step` to your action, specifying `Rscript {0}` as the `shell` for that step. Here's an example from the [bookdown action](https://github.com/r-lib/actions/tree/v2-branch/examples#build-bookdown-site):\n    ```yaml\n    - name: Build site\n      run: bookdown::render_book(\"index.Rmd\", quiet = TRUE)\n      shell: Rscript {0}\n   ```\n\n## Additional resources\n\n- [GitHub Actions for R](https://www.jimhester.com/talk/2020-rsc-github-actions/), Jim Hester's talk at rstudio::conf 2020. [Recording](https://resources.rstudio.com/rstudio-conf-2020/azure-pipelines-and-github-actions-jim-hester), [slidedeck](https://speakerdeck.com/jimhester/github-actions-for-r).\n- [GitHub Actions advent calendar](https://www.edwardthomson.com/blog/github_actions_advent_calendar.html) a series of blogposts by Edward Thomson, one of the GitHub Actions product managers\n  highlighting features of GitHub Actions.\n- [GitHub Actions with R](https://ropenscilabs.github.io/actions_sandbox/) - a short online book about using GitHub Actions with R, produced as part of the [rOpenSci OzUnconf](https://ozunconf19.ropensci.org/).\n- [Awesome Actions](https://github.com/sdras/awesome-actions#awesome-actions---) - a curated list of custom actions. **Note** that many of these are from early in the GitHub Actions beta and may no longer work.\n\n## License ![CC0 licensed](https://img.shields.io/github/license/r-lib/actions)\n\nAll examples in this repository are published with the [CC0](./LICENSE) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-lib%2Factions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr-lib%2Factions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr-lib%2Factions/lists"}