{"id":19490379,"url":"https://github.com/rstudio/tblcheck","last_synced_at":"2025-04-25T19:31:47.260Z","repository":{"id":42059424,"uuid":"362879887","full_name":"rstudio/tblcheck","owner":"rstudio","description":"Checks for grading tabular data","archived":false,"fork":false,"pushed_at":"2023-03-11T01:29:45.000Z","size":2744,"stargazers_count":10,"open_issues_count":14,"forks_count":1,"subscribers_count":37,"default_branch":"main","last_synced_at":"2025-04-22T19:03:42.023Z","etag":null,"topics":["autograding","gradethis","learnr","tables","tibbles"],"latest_commit_sha":null,"homepage":"https://pkgs.rstudio.com/tblcheck","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rstudio.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-29T16:26:49.000Z","updated_at":"2024-06-22T16:14:32.000Z","dependencies_parsed_at":"2023-02-02T20:15:18.312Z","dependency_job_id":null,"html_url":"https://github.com/rstudio/tblcheck","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Ftblcheck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Ftblcheck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Ftblcheck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Ftblcheck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rstudio","download_url":"https://codeload.github.com/rstudio/tblcheck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250882637,"owners_count":21502341,"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":["autograding","gradethis","learnr","tables","tibbles"],"created_at":"2024-11-10T21:12:41.429Z","updated_at":"2025-04-25T19:31:46.963Z","avatar_url":"https://github.com/rstudio.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n\tcollapse = TRUE,\n\tcomment = \"#\u003e\",\n\tfig.path = \"man/figures/README-\",\n\tout.width = \"100%\"\n)\n```\n\n# tblcheck \u003cimg alt=\"tblcheck hex logo\" src='man/figures/logo.png' align=\"right\" height=\"120\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![CRAN status](https://www.r-pkg.org/badges/version/tblcheck)](https://CRAN.R-project.org/package=tblcheck)\n[![R-CMD-check](https://github.com/rstudio/tblcheck/workflows/R-CMD-check/badge.svg)](https://github.com/rstudio/tblcheck/actions)\n\u003c!-- [![](http://cranlogs.r-pkg.org/badges/last-month/tblcheck?color=blue)](https://cran.r-project.org/package=tblcheck) --\u003e\n\u003c!-- badges: end --\u003e\n\ntblcheck provides functions for grading tibbles, data frames, and vectors with [gradethis](https://pkgs.rstudio.com/gradethis/). \n\ngradethis is designed for use with [gradethis](https://pkgs.rstudio.com/gradethis/) in [learnr](https://rstudio.github.io/learnr/) tutorials. We recommend that you first be comfortable grading [learnr](https://rstudio.github.io/learnr/) tutorials with [gradethis](https://pkgs.rstudio.com/gradethis/) before you begin using tblcheck. You can learn more with the [gradethis package documentation](https://pkgs.rstudio.com/gradethis/) and the [learnr package documentation](https://rstudio.github.io/learnr/).\n\n\u003cimg src=\"man/figures/screenshot.png\" alt=\"A screenshot of the tblcheck package in action. An exercise starts with the following instructions: 'Create a tibble with two columns. The first column should be called \u0026quot;fruit\u0026quot; and contain the value \u0026quot;tomato\u0026quot;. The second column should be called \u0026quot;color\u0026quot; and contain the value \u0026quot;red\u0026quot;.' The student has entered the following code: 'tibble(vegetable = \u0026quot;tomato\u0026quot;, color = \u0026quot;red\u0026quot;)'. The tblcheck package generates the following message: 'Your table should have a column named \u0026quot;fruit\u0026quot;. Your table should not have a column named \u0026quot;vegetable\u0026quot;. Please try again.'\" style=\"border: 1px solid black; box-shadow: 5px 5px 5px #eee; max-width: 66%; display: block; margin: 1em auto;\"\u003e\n\n## Installation\n\n\u003c!-- You can install the released version of tblcheck from [CRAN](https://CRAN.R-project.org) with: --\u003e\n\n\u003c!-- ``` r --\u003e\n\u003c!-- install.packages(\"tblcheck\") --\u003e\n\u003c!-- ``` --\u003e\n\ntblcheck is still in development and not on [CRAN](https://CRAN.R-project.org) yet. The development version of tblcheck can be installed from GitHub with:\n\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"rstudio/tblcheck\")\n```\n\n## Usage\n\nTo use tblcheck in a learnr tutorial, start by loading tblcheck after learnr and gradethis in the `setup` chunk of your tutorial:\n\n```` markdown\n```{r setup}`r \"\"`\nlibrary(learnr)\nlibrary(gradethis)\nlibrary(tblcheck)\nlibrary(tibble)\n```\n````\n\nThen include one of the tblcheck functions in your gradethis code:\n\n```` markdown\n```{r exercise, exercise = TRUE}`r \"\"`\n\n```\n\n```{r exercise-solution}`r \"\"`\ntibble(fruit = \"tomato\", color = \"red\")\n```\n\n```{r exercise-check}`r \"\"`\ngrade_this_table()\n```\n````\n\n`grade_this_table()` compares the `.result` generated by a students' code to the `.solution` generated in the `exercise-solution` chunk.\n\n- `grade_this_table()` passes the student's `.result` if it's identical to the `.solution`,\n  or if a difference is detected, it produces a failing grade\n  with a message describing the problem with the table.\n\n- `grade_this_table()` is built on gradethis functions and `tbl_grade()`,\n  which can be used in exercise grading code to detect problems in tables.\n  \n- `tbl_grade()`, in turn, is built on lower-level functions that can be used directly\n  to compare specific aspects of two tables.\n\nLearn more about the various tblcheck functions in `vignette(\"tblcheck\")`.\n\n## Code of Conduct\n  \nPlease note that the tblcheck project is released with a [Contributor Code of Conduct](https://contributor-covenant.org/version/2/0/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Ftblcheck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frstudio%2Ftblcheck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Ftblcheck/lists"}