wflow_status: Report status of workflowr project.
In jdblischak/workflowrBeta: A workflow template for creating a research website

Description Usage Arguments Details Value Examples

wflow_status reports the analysis files that require user action.

1	wflow_status(files = NULL, project = ".")

`files`	character (default: NULL) The analysis file(s) to report the status. By default checks the status of all analysis files. Supports file globbing.
`project`	character (default: ".") By default the function assumes the current working directory is within the project. If this is not true, you'll need to provide the path to the project directory.

wflow_status reports analysis files with one of the following statuses:

Mod: Modified file. Any published file that has been modified since the last time the HTML was published.
Unp: Unpublished file. Any tracked file whose corresponding HTML is not tracked. May or may not have staged or unstaged changes.
Scr: Scratch file. Any untracked file that is not specifically ignored.

wflow_status only works for workflowr projects that use Git.

Returns an object of class wflow_status, which is a list with the following elements:

root: The relative path to the root directory of the workflowr project (i.e. contains the RStudio .Rproj file).
analysis: The relative path to the directory that contains _site.yml and the R Markdown files.
docs: The relative path to the directory that contains the HTML files and figures.
git: The relative path to the .git directory that contains the history of the Git repository.
status: A data frame with detailed information on the status of each file (see below).

The data frame status contains the following non-mutually exclusive columns (all logical vectors):

ignored: The R Markdown file has been ignored by Git according to the patterns in the file .gitignore.
mod_unstaged: The R Markdown file has unstaged modifications.
mod_staged: The R Markdown file has staged modifications.
tracked: The R Markdown file is tracked by Git.
committed: The R Markdown file has been previously committed to the Git repository.
published: The corresponding HTML file has been previously committed.
mod_committed: The R Markdown file has modifications that have been committed since the last time the HTML was built and committed.
modified: The R Markdown file has been modified since it was last published (i.e. mod_unstaged or mod_staged or mod_committed).
unpublished: The R Markdown file is tracked by Git but not published (i.e. the HTML has not been committed).
scratch: The R Markdown file is untracked by Git, i.e. it is considered a scratch file until it is committed.

## Not run: 

wflow_status()
# Get status of specific file(s)
wflow_status("analysis/file.Rmd")
# Save the results
s <- wflow_status()

## End(Not run)