From 619ddbdb1b72ae6076d604fc14957715a050bf7b Mon Sep 17 00:00:00 2001 From: Matt Cowgill Date: Fri, 11 Aug 2023 16:37:31 +1000 Subject: [PATCH] Update `read_payroll()` function (again!) to reflect changes by the ABS (#237) * fix payrolls for yet another ABS change * refresh sysdata --- R/read_payrolls.R | 48 +++++++++++++++------------- R/sysdata.rda | Bin 35529 -> 35545 bytes man/download_previous_payrolls.Rd | 2 +- man/read_payrolls.Rd | 15 +++++---- tests/testthat/test-read_payrolls.R | 1 - 5 files changed, 35 insertions(+), 31 deletions(-) diff --git a/R/read_payrolls.R b/R/read_payrolls.R index 5a67c1c..67ad6f1 100644 --- a/R/read_payrolls.R +++ b/R/read_payrolls.R @@ -2,8 +2,8 @@ #' #' Import a tidy tibble of ABS Weekly Payrolls data. #' -#' @details The ABS 'Weekly Payroll Jobs and Wages in Australia' dataset -#' is very useful to analysts of the Australian labour market. +#' @details The ABS [Weekly Payroll Jobs](https://www.abs.gov.au/statistics/labour/jobs/weekly-payroll-jobs/latest-release#changes-in-this-release) +#' dataset is useful to analysts of the Australian labour market. #' It draws upon data collected #' by the Australian Taxation Office as part of its Single-Touch Payroll #' initiative and supplements the monthly Labour Force Survey. Unfortunately, @@ -16,8 +16,6 @@ #' \itemize{ #' \item{"industry_jobs"}{ Payroll jobs by industry division, state, sex, and age #' group (Table 4)} -#' \item{"industry_wages"}{ Total wages by industry division, state, sex, and age -#' group (Table 4)} #' \item{"sa4_jobs"}{ Payroll jobs by statistical area 4 (SA4) and state (Table 5)} #' \item{"sa3_jobs}{ Payroll jobs by statistical area 4 (SA4), statistical #' area 3 (SA3), and state (Table 5)} @@ -32,6 +30,11 @@ #' The default is "industry_jobs". #' @return A tidy (long) `tbl_df`. The number of columns differs based on the `series`. #' +#' @details +#' Note that this ABS release used to be called Weekly Payroll Jobs and Wages Australia. +#' The total wages series were removed from this release in mid-2023 and it +#' was renamed to Weekly Payroll Jobs. The ability to read total wages +#' indexes using this function was therefore also removed. #' @examples #' \dontrun{ #' # Fetch payroll jobs by industry and state (the default, "industry_jobs") @@ -52,7 +55,6 @@ read_payrolls <- function(series = c( "industry_jobs", - "industry_wages", "sa4_jobs", "sa3_jobs", "subindustry_jobs", @@ -65,11 +67,14 @@ read_payrolls <- function(series = c( )) { check_abs_connection() + if (series == "industry_wages") { + stop("The ABS removed wages totals from the Weekly Payrolls Jobs release.") + } + series <- match.arg(series) cube_name <- switch(series, "industry_jobs" = "DO004", - "industry_wages" = "DO004", "sa4_jobs" = "DO005", "sa3_jobs" = "DO005", "subindustry_jobs" = "DO006", @@ -108,7 +113,6 @@ read_payrolls <- function(series = c( sheet_name <- switch(series, "industry_jobs" = "Payroll jobs index", - "industry_wages" = "Total wages index", "sa4_jobs" = "SA4", "sa3_jobs" = "SA3", "subindustry_jobs" = "Payroll jobs index-Subdivision", @@ -119,8 +123,7 @@ read_payrolls <- function(series = c( cube <- read_payrolls_local( cube_path = cube_path, - sheet_name = sheet_name, - series = series + sheet_name = sheet_name ) cube @@ -129,12 +132,12 @@ read_payrolls <- function(series = c( #' @keywords internal #' @param cube_path Path + filename (incl. extension) to ABS payrolls data cube #' @param sheet_name Name of the sheet on the Excel cube to import -#' @param series "wages" or "jobs" (the default) #' @noRd -read_payrolls_local <- function(cube_path, sheet_name, series = "jobs") { +read_payrolls_local <- function(cube_path, sheet_name) { sheets_present <- readxl::excel_sheets(cube_path) sheets_present <- sheets_present[!sheets_present == "Contents"] + series <- "jobs" sheet_to_read <- sheets_present[grepl(sheet_name, sheets_present, @@ -204,11 +207,7 @@ read_payrolls_local <- function(cube_path, sheet_name, series = "jobs") { perl = TRUE ) - if (grepl("wages", series)) { - cube$series <- "wages" - } else { - cube$series <- "jobs" - } + cube$series <- "jobs" cube } @@ -221,7 +220,7 @@ read_payrolls_local <- function(cube_path, sheet_name, series = "jobs") { #' release and attemps to download it. This function will no longer be required #' if/when the ABS reverts to the previous release arrangements. The function #' is internal and is called by `read_payrolls()`. -#' @param cube_name eg. DO005 for table 5 +#' @param cube_name eg. DO004 for table 4 #' @param path Directory in which to download payrolls cube #' @keywords internal #' @return A list containing two elements: `result` (will contain path + filename @@ -229,7 +228,7 @@ read_payrolls_local <- function(cube_path, sheet_name, series = "jobs") { #' downloaded successfully; character otherwise). download_previous_payrolls <- function(cube_name, path) { - latest_payrolls_url <- "https://www.abs.gov.au/statistics/labour/earnings-and-work-hours/weekly-payroll-jobs-and-wages-australia/latest-release" + latest_payrolls_url <- "https://www.abs.gov.au/statistics/labour/jobs/weekly-payroll-jobs/latest-release" prev_payrolls_css <- "#release-date-section > div.field.field--name-dynamic-block-fieldnode-previous-releases.field--type-ds.field--label-hidden > div > div > ul > li:nth-child(1) > a" temp_page_location <- file.path(tempdir(), "temp_readabs.html") @@ -241,10 +240,10 @@ download_previous_payrolls <- function(cube_name, prev_payrolls_url <- paste0("https://www.abs.gov.au/", prev_payrolls_url) - temp_page_location <- file.path(tempdir(), "temp_readabs.html") - dl_file(prev_payrolls_url, temp_page_location) + prev_page_location <- file.path(tempdir(), "temp_readabs_prev.html") + dl_file(prev_payrolls_url, prev_page_location) - prev_payrolls_page <- rvest::read_html(temp_page_location) + prev_payrolls_page <- rvest::read_html(prev_page_location) prev_payrolls_excel_links <- prev_payrolls_page %>% rvest::html_elements(".file--x-office-spreadsheet a") %>% @@ -261,14 +260,17 @@ download_previous_payrolls <- function(cube_name, stop("Found multiple patching URLs for the requested cube in previous payrolls release") } + if (!grepl("abs.gov.au", table_link)) { + table_link <- paste0("https://www.abs.gov.au", table_link) + } + safely_download <- purrr::safely(dl_file) full_path <- file.path(path, basename(table_link)) dl_result <- safely_download( url = table_link, - destfile = full_path, - mode = "wb" + destfile = full_path ) out <- list( diff --git a/R/sysdata.rda b/R/sysdata.rda index d3bb6d767f1a35b62fbb197461c1d94041fe0469..4e094aa149ca5542f560409a9e0b096dcada0d58 100644 GIT binary patch literal 35545 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 z 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 diff --git a/man/download_previous_payrolls.Rd b/man/download_previous_payrolls.Rd index f5201c9..73dd4e4 100644 --- a/man/download_previous_payrolls.Rd +++ b/man/download_previous_payrolls.Rd @@ -13,7 +13,7 @@ is internal and is called by \code{read_payrolls()}.} download_previous_payrolls(cube_name, path) } \arguments{ -\item{cube_name}{eg. DO005 for table 5} +\item{cube_name}{eg. DO004 for table 4} \item{path}{Directory in which to download payrolls cube} } diff --git a/man/read_payrolls.Rd b/man/read_payrolls.Rd index 96e763c..96d89bd 100644 --- a/man/read_payrolls.Rd +++ b/man/read_payrolls.Rd @@ -5,8 +5,8 @@ \title{Download and tidy ABS payroll jobs and wages data} \usage{ read_payrolls( - series = c("industry_jobs", "industry_wages", "sa4_jobs", "sa3_jobs", - "subindustry_jobs", "empsize_jobs", "gccsa_jobs", "sex_age_jobs"), + series = c("industry_jobs", "sa4_jobs", "sa3_jobs", "subindustry_jobs", "empsize_jobs", + "gccsa_jobs", "sex_age_jobs"), path = Sys.getenv("R_READABS_PATH", unset = tempdir()) ) } @@ -15,8 +15,6 @@ read_payrolls( \itemize{ \item{"industry_jobs"}{ Payroll jobs by industry division, state, sex, and age group (Table 4)} -\item{"industry_wages"}{ Total wages by industry division, state, sex, and age -group (Table 4)} \item{"sa4_jobs"}{ Payroll jobs by statistical area 4 (SA4) and state (Table 5)} \item{"sa3_jobs}{ Payroll jobs by statistical area 4 (SA4), statistical area 3 (SA3), and state (Table 5)} @@ -43,8 +41,8 @@ A tidy (long) \code{tbl_df}. The number of columns differs based on the \code{se Import a tidy tibble of ABS Weekly Payrolls data. } \details{ -The ABS 'Weekly Payroll Jobs and Wages in Australia' dataset -is very useful to analysts of the Australian labour market. +The ABS \href{https://www.abs.gov.au/statistics/labour/jobs/weekly-payroll-jobs/latest-release#changes-in-this-release}{Weekly Payroll Jobs} +dataset is useful to analysts of the Australian labour market. It draws upon data collected by the Australian Taxation Office as part of its Single-Touch Payroll initiative and supplements the monthly Labour Force Survey. Unfortunately, @@ -52,6 +50,11 @@ the data as published by the ABS (1) is not in a standard time series spreadsheet; and (2) is messy in various ways that make it hard to read in R. This convenience function uses \code{download_abs_data_cube()} to import the payrolls data, and then tidies it up. + +Note that this ABS release used to be called Weekly Payroll Jobs and Wages Australia. +The total wages series were removed from this release in mid-2023 and it +was renamed to Weekly Payroll Jobs. The ability to read total wages +indexes using this function was therefore also removed. } \examples{ \dontrun{ diff --git a/tests/testthat/test-read_payrolls.R b/tests/testthat/test-read_payrolls.R index f059510..0af91bc 100644 --- a/tests/testthat/test-read_payrolls.R +++ b/tests/testthat/test-read_payrolls.R @@ -16,7 +16,6 @@ test_that("read_payrolls() works", { purrr::map( c( "industry_jobs", - "industry_wages", "sa4_jobs", "sa3_jobs", "subindustry_jobs",