Skip to content

Commit

Permalink
Prepping package for beta release
Browse files Browse the repository at this point in the history
  • Loading branch information
lfagliano committed Dec 1, 2023
1 parent d06fcec commit 235eaf4
Show file tree
Hide file tree
Showing 31 changed files with 42 additions and 440 deletions.
6 changes: 6 additions & 0 deletions .lintr
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
linters: linters_with_defaults(
line_length_linter = line_length_linter(120)

)

encoding: "UTF-8"
4 changes: 2 additions & 2 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -45,8 +45,8 @@ Imports:
RoxygenNote: 7.2.3
Depends:
R (>= 3.5.0)
URL: https://github.com/billingtt/acledR, https://billingtt.github.io/acledR/, https://acled.github.io/acledR/
BugReports: https://github.com/billingtt/acledR/issues
URL: https://github.com/ACLED/acledR, https://acled.github.io/acledR/
BugReports: https://github.com/ACLED/acledR/issues
Suggests:
knitr,
janitor,
Expand Down
1 change: 0 additions & 1 deletion R/.lintr

This file was deleted.

24 changes: 12 additions & 12 deletions README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,11 @@ knitr::opts_chunk$set(
[![codecov](https://codecov.io/gh/ACLED/acledR/graph/badge.svg?token=TDJodXhEvx)](https://codecov.io/gh/ACLED/acledR)
<!-- badges: end -->

Welcome to ACLED's official R package! With this package we want to bring you an even more convenient way to access ACLED data, building on top of our existing API.

In this repo you can find the source code of the package, as well as the documentation. You can also visit https://acled.github.io/acledR/ for more information and walkthroughs on how to use the package.


# Overview

This package provides tools to extract and manipulate data from the [Armed Conflict Location and Event Data Project (ACLED)](https://acleddata.com/).
Expand All @@ -39,7 +44,7 @@ Since the package repo is currently private, you need to tell R and Github that
usethis::create_github_token()
```

After you've copied the PAT from the browser, return to R and run this, which will store the PAT locally.
After you've copied the PAT from the browser and saved it somewhere safe, return to R and run this, which will store the PAT locally.

```{r, eval=F}
# paste the token where it says YourPAT
Expand All @@ -48,15 +53,6 @@ credentials::set_github_pat("YourPAT")
Sys.getenv("GITHUB_PAT")
```

I recommend also setting the PAT in your `.Rprofile` so it's stored for all R sessions (i.e., you don't have to save the PAT and paste it in each time you re-install).

```{r, eval=F}
# to set your PAT for all R sessions, run
file.edit(file.path("~", ".Rprofile"))
# and then paste credentials::set_github_pat("YourPAT") into the .Rprofile script
# save the file
```

Now you can install the package and it will automatically locate your PAT.

```{r, eval=F}
Expand All @@ -67,8 +63,12 @@ devtools::install_github("ACLED/acledR")

## Installation (for public use)

Until the acledR package gets added into the Comprehensive R Archive Network (CRAN), users can utilize devtools to install the package from Github. Thankfully, the installation is rather simple. You can install it through the following code:

The package is on the process to get submited to the Comprehensive R Archive Network (CRAN). In the meantime, you can install the package from Github.
```{r, eval = F}
devtools::install_github("ACLED/acledR") ## if you are interested in a particular branch, please add a 'ref' argument.
```

Once the package is uploaded to CRAN, you can install it with the following command:
```{r, eval = F}
install.packages("acledR")
```
234 changes: 0 additions & 234 deletions inst/rmarkdown/templates/template1.Rmd

This file was deleted.

30 changes: 0 additions & 30 deletions test.r

This file was deleted.

Binary file removed vignettes/.trackdown/acled_codebook.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/acled_codebook.Rmd-header_info.rds
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed vignettes/.trackdown/acled_sources.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/acled_sources.Rmd-header_info.rds
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file removed vignettes/.trackdown/event_types.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/event_types.Rmd-header_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/fatalities.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/fatalities.Rmd-header_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/geography.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/geography.Rmd-header_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/time.Rmd-chunk_info.rds
Binary file not shown.
Binary file removed vignettes/.trackdown/time.Rmd-header_info.rds
Binary file not shown.
Loading

0 comments on commit 235eaf4

Please sign in to comment.