Refactor to fix erase_water() #172 + #151 + #184 + improve error checking w/ rlang

.Rbuildignore

@@ -8,3 +8,4 @@
 ^img$
 
 ^\.github$
+^README\.Rmd$

DESCRIPTION

@@ -1,39 +1,42 @@
-Package: tigris
 Type: Package
+Package: tigris
 Title: Load Census TIGER/Line Shapefiles
-Version: 2.0.6
-Date: 2024-01-23
+Version: 2.1.1
+Date: 2024-03-26
 Authors@R: c(
-      person(given="Kyle", family="Walker", email="[email protected]", role=c("aut", "cre")),
-      person(given="Bob", family="Rudis", email="[email protected]", role="ctb")
-    )
-URL: https://github.com/walkerke/tigris
-BugReports: https://github.com/walkerke/tigris/issues
-Description: Download TIGER/Line shapefiles from the United States Census Bureau 
-    (<https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html>) 
+    person("Kyle", "Walker", , "[email protected]", role = c("aut", "cre")),
+    person("Bob", "Rudis", , "[email protected]", role = "ctb"),
+    person("Eli", "Pousson", , "[email protected]", role = "ctb")
+  )
+Description: Download TIGER/Line shapefiles from the United States Census
+    Bureau
+    (<https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html>)
     and load into R as 'sf' objects.
 License: MIT + file LICENSE
-LazyData: TRUE
-Encoding: UTF-8
+URL: https://github.com/walkerke/tigris
+BugReports: https://github.com/walkerke/tigris/issues
 Depends:
     R (>= 3.3.0)
+Imports:
+    dplyr,
+    httr,
+    magrittr,
+    methods,
+    rappdirs,
+    rlang,
+    sf,
+    utils
 Suggests:
-    testthat,
     ggplot2,
     ggthemes,
+    knitr,
     leaflet,
-    knitr, 
+    sp,
+    testthat (>= 3.0.0),
     tidycensus,
-    sp
-Imports:
-    stringr,
-    magrittr,
-    utils,
-    rappdirs,
-    httr,
-    uuid, 
-    sf, 
-    dplyr, 
-    methods
-RoxygenNote: 7.2.3
+    withr
+Config/testthat/edition: 3
+Encoding: UTF-8
+LazyData: TRUE
 Roxygen: list(markdown = TRUE)
+RoxygenNote: 7.3.1

NAMESPACE

@@ -53,19 +53,42 @@ export(tribal_block_groups)
 export(tribal_census_tracts)
 export(tribal_subdivisions_national)
 export(urban_areas)
+export(validate_county)
+export(validate_state)
 export(voting_districts)
 export(zctas)
 import(dplyr)
 import(httr)
-import(rappdirs)
-import(sf)
+import(rlang)
 import(utils)
-import(uuid)
 importFrom(dplyr,mutate)
 importFrom(httr,GET)
+importFrom(httr,HEAD)
+importFrom(httr,http_error)
+importFrom(httr,progress)
 importFrom(httr,stop_for_status)
+importFrom(httr,write_disk)
 importFrom(magrittr,"%>%")
 importFrom(methods,as)
-importFrom(stringr,str_pad)
-importFrom(stringr,str_trim)
+importFrom(rappdirs,user_cache_dir)
+importFrom(sf,as_Spatial)
+importFrom(sf,st_as_sf)
+importFrom(sf,st_as_sfc)
+importFrom(sf,st_as_text)
+importFrom(sf,st_bbox)
+importFrom(sf,st_cast)
+importFrom(sf,st_centroid)
+importFrom(sf,st_crs)
+importFrom(sf,st_difference)
+importFrom(sf,st_geometry)
+importFrom(sf,st_geometry_type)
+importFrom(sf,st_intersection)
+importFrom(sf,st_intersects)
+importFrom(sf,st_is_valid)
+importFrom(sf,st_make_valid)
+importFrom(sf,st_point)
+importFrom(sf,st_read)
+importFrom(sf,st_sfc)
+importFrom(sf,st_transform)
+importFrom(sf,st_union)
 importFrom(utils,URLencode)

NEWS

@@ -1,3 +1,44 @@
+tigris (development)
+-------------------------------------------------------
+
+### New features
+
+* Functions in tigris now default to a year of 2022.
+
+New support for downloading multiple existing or new datasets:
+
+* 2022 or 2023 (118th Congress) data for `congressional_districts()` (#180)
+
+* 2010 data for `area_water()`, `linear_water()`, `roads()`, `primary_roads()`, `primary_secondary_roads()`, `rails()`, `military()`, `landmarks()`,  `tribal_block_groups()` and `tribal_census_tracts()`.
+
+* 2000 and 2010 data for `places()` (#129), `native_areas()`, `tribal_subdivisions_national()`, and `alaska_native_regional_corporations()`.
+
+Improved input validation both for specific functions and in general:
+
+* All functions use consistent validation for `year`, `state`, and `county` parameters. If state or county is required, functions error (instead of warning) for `NULL` or invalid values.
+
+* Error when `year = 2022` for `combined_statistical_areas()` and `core_based_statistical_areas()`. (#184)
+
+* Error if URL does not exist (rather than retrying download). (#185)
+
+* Warn users when `filter_by` contains multiple geometries and only part of the filter can be used.
+
+### Bug fixes
+
+* `erase_water()` will not fail when `input_sf` doesn't intersect with any water areas. (#172, #182)
+
+### Internal changes
+
+* Remove `{stringr}` and `{uuid}` from Imports and add `{rlang}`
+
+* Add `{withr}` to Suggests (for tests only).
+
+* Switch to use `rlang::abort()`, `rlang::warn()` and `rlang::inform()` for all errors, warnings, and messages.
+
+* Add `multiple` argument to `validate_state()` and `validate_county()` to allow validation of multiple states or counties in a single call. Export both validation functions as internal functions.
+
+* Refactor and add helper functions (`set_tigris_year()`, `check_tigris_year()`, and `url_tiger()`) to reduce duplication and make code more maintainable.
+
 tigris 2.0
 -------------------------------------------------------
 * A new filter_by argument allows users to subset datasets by a bounding box or another sf object when requesting data.