grader

helps grade R script assignment submissions!

https://github.com/tbrown122387/grader

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (16.3%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

helps grade R script assignment submissions!

Basic Info
  • Host: GitHub
  • Owner: tbrown122387
  • License: other
  • Language: R
  • Default Branch: master
  • Size: 546 KB
Statistics
  • Stars: 4
  • Watchers: 1
  • Forks: 25
  • Open Issues: 10
  • Releases: 6
Created almost 7 years ago · Last pushed about 4 years ago
Metadata Files
Readme Changelog Contributing License Citation

README.Rmd

---
output: github_document
---



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





The goal of `gradeR` is to help grade bunches of `R` script assignment submissions. This package has two primary functions called `calcGrades()` and `calcGradesForGradescope`, and much of the testing functionality is taken from the `testthat` package.

## Installation

You can install the released version of `gradeR` from [CRAN](https://CRAN.R-project.org) with:

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

You can install the development version of `gradeR` with:

``` r
# install.packages("devtools")
devtools::install_github("tbrown122387/gradeR")
```

## Example

This is a basic overview which shows you how to grade a bunch of assignment submissions. Make sure to change the paths to ones that actually exist on your machine. For more details on this example, see the vignette.

``` r
# load in the package
library(gradeR)

# this is the directory with all of the student submissions
submissionDir <- "../submissions/"

# get the grades
grades <- calcGrades(submission_dir = submissionDir, 
                     your_test_file = "~/your/path/assignment1_test_file.r")
```

The directory of the first argument will be walked recursively, and any
file ending in a `.R` or `.r` will be `source`d and tested using the tests in the `assignment1_grading_file.r`. 

The file with the tests is specified in the second argument. This is a file you must create on your own. For more information on how to write `testthat` tests, see [this.](https://cran.r-project.org/package=testthat)

It might be beneficial to recommend that your students:

- clear out their workspace and `source` their `.R` submissions before submitting them. This makes sure everything runs as expected (at least on their machine).
- to not rename files that are read in as data, or change any raw data files on *their* hard drives. If they forget to abide by this rule, you will have to edit their submission and rename file names in their script.
- to not use global file paths (have them interactively use `setwd()`, and then read in files using only their name). If they forget to do this, then you will need to change all of the global paths to local paths on their machine.

## Contributing

Please see `CONTRIBUTING.md` for more information on how you can contribute to this project!

Owner

  • Name: Taylor R. Brown
  • Login: tbrown122387
  • Kind: user
  • Company: University of Virginia

Citation (CITATION.cff)

cff-version: 1.2.0
title: 'gradeR: helps grade R script assignment submissions'
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Taylor
    family-names: Brown
    email: tbrown122387@gmail.com
    affiliation: University of Virginia Department of Statistics
    orcid: 'https://orcid.org/0000-0003-4972-6251'
version: 1.0.11
doi: 10.5281/zenodo.5768314 
date-released: 2021-12-08
url: "https://github.com/tbrown122387/gradeR"

GitHub Events

Total
  • Issue comment event: 12
  • Pull request event: 24
  • Fork event: 24
Last Year
  • Issue comment event: 12
  • Pull request event: 24
  • Fork event: 24

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1
  • Total pull requests: 4
  • Average time to close issues: 5 days
  • Average time to close pull requests: 9 months
  • Total issue authors: 1
  • Total pull request authors: 4
  • Average comments per issue: 4.0
  • Average comments per pull request: 3.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 4
  • Average time to close issues: N/A
  • Average time to close pull requests: 9 months
  • Issue authors: 0
  • Pull request authors: 4
  • Average comments per issue: 0
  • Average comments per pull request: 3.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • bestilley (1)
  • Ciel-Gao (1)
  • DanielAmes (1)
  • AndrewHunter10 (1)
  • WZining (1)
  • samiadam7 (1)
  • vihinii (1)
  • GrateTheSteve (1)
  • QueensleyC (1)
  • schild08 (1)
  • cjw8rqn (1)
  • TY76751 (1)
  • vkgurbani (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

DESCRIPTION cran
  • R >= 3.4 depends
  • callr * imports
  • jsonlite * imports
  • methods * imports
  • testthat * imports
  • knitr * suggests
  • rmarkdown * suggests