Description

This PR seeks to add factor levels and their associated order to the event names and their associated labels when available in the redcap_events column of the supertibble. It does not change how redcap_event appears in the data tibbles of the supertibble, which I think is fine since it should represent the REDCapR output. Users can easily get the level order from the redcap_events column of the supertibble with this branch's setup and it will serve my use case for REDCapExploreR.

Proposed Changes

List changes below in bullet format:

Add forcats to DESCRIPTION to make use of fct_inorder()
Update link_arms() to establish and assign factor levels and orders
Update add_event_mapping() to use link_arms() output and assign factor levels and order
Update associated tests

Issue Addressed

Closes #210

PR Checklist

Before submitting this PR, please check and verify below that the submission meets the below criteria:

[ ] New/revised functions have associated tests
[ ] New/revised functions that update downstream outputs have associated static testing files (.RDS) updated under inst/testdata/create_test_data.R
[x] New/revised functions use appropriate naming conventions
[x] New/revised functions don't repeat code
[x] Code changes are less than 250 lines total
[x] Issues linked to the PR using GitHub's list of keywords
[x] The appropriate reviewer is assigned to the PR
[x] The appropriate developers are assigned to the PR
[x] Pre-release package version incremented using usethis::use_version()

Code Review

This section to be used by the reviewer and developers during Code Review after PR submission

Code Review Checklist

[ ] I checked that new files follow naming conventions and are in the right place
[ ] I checked that documentation is complete, clear, and without typos
[ ] I added/edited comments to explain "why" not "how"
[ ] I checked that all new variable and function names follow naming conventions
[ ] I checked that new tests have been written for key business logic and/or bugs that this PR fixes
[ ] I checked that new tests address important edge cases

To see the specific tasks where the Asana app for GitHub is being used, see below:
- https://app.asana.com/0/0/1208692068485305

CHOP-CGTInformatics / REDCapTidieR