Skip to contents

Changelog

Source: NEWS.md

ColombiAPI 0.3.2

CRAN Policy Compliance — Graceful Failure for Internet Resources

This release fixes all functions that use internet resources to comply with the CRAN policy: “Packages which use Internet resources should fail gracefully with an informative message if the resource is not available or has changed.”

Functions fixed — API Colombia

Functions fixed — World Bank API

Functions fixed — Nager.Date API

  • get_colombia_holidays(): Added @details, @note, and @seealso roxygen tags for consistency with the rest of the package. Removed internal comments for cleaner code. All graceful failure handling was already correctly implemented.

Functions fixed — REST Countries API

  • get_country_info_co(): Added httr::timeout(10), tryCatch() on httr::content(), nchar(txt) == 0 validation for empty responses, and defensive field extraction with NA_character_ / NA_real_ fallbacks for all fields. Removed Spanish-language error messages for consistency. Renamed internal variable response to res. Replaced \donttest{} with if (interactive()) in examples. Expanded @return, @description, @details, and @note roxygen tags for consistency.

Additional improvements across all fixed functions

  • Replaced res$status_code with httr::status_code(res) (correct httr idiom).
  • Corrected is.null() check order — always evaluated before length() to prevent errors when object is NULL.
  • Replaced \donttest{} with if (interactive()) in all examples for consistency.
  • Removed unnecessary return(df) at end of functions (idiomatic R style).
  • Updated @importFrom httr directives to include timeout and status_code where missing.
  • Updated copyright year from 2025 to 2025-2026.

ColombiAPI 0.3.1

CRAN release: 2025-10-12

Bug Fixes

Test Corrections for CRAN Compliance

  • Fixed get_colombia_literacy_rate() tests: Corrected data type expectations for the value column from integer to numeric. The World Bank API returns literacy rates as decimal percentages (e.g., 95.68%), which are naturally of type numeric/double, not integer.

  • Fixed get_colombia_life_expectancy() tests:

    • Added skip_on_cran() to all tests to properly handle offline environments during CRAN checks
    • Improved error handling by adding User-Agent headers to HTTP requests
    • Added explicit NULL checks before structure validation to prevent test failures
    • Enhanced robustness of API error handling with better tryCatch() implementation

ColombiAPI 0.3.0

CRAN release: 2025-09-29

Breaking Changes

This release significantly expands the scope of ColombiAPI with 12 new curated datasets.

These additions cover diverse domains such as indigenous languages, education, biodiversity, digital transformation, mobility, tourism, connectivity, and economic projections.

Newly Added Datasets

  • indigenous_vocabulary_df: Comparative Vocabulary for Colombia’s Indigenous Languages
  • admitted_students_df: Admitted Students to the Science Faculty, UNAL (2013-I)
  • school_levels_df: Departments by Levels of Schools in Colombia
  • dead_lianas_df: Mortality of lianas (vines) in tropical forests
  • municipalities_tbl_df: Municipalities of Colombia
  • Bucaramanga_wifi_tbl_df: WiFi Connectivity Zones in Bucaramanga
  • Cartagena_wifi_tbl_df: Connected Devices in WiFi Zones of Cartagena
  • digital_graduates_tbl_df: “Advancing in Digital” Program Graduates
  • vehicle_count_tbl_df: Vehicle Count: Cars and Motorcycles
  • foreign_visitors_tbl_df: Non-Resident Foreign Visitors to Colombia
  • digital_centers_tbl_df: Digital Centers in Sucre
  • gdp_departments_tbl_df: Departmental GDP Projection

ColombiAPI 0.2.0

CRAN release: 2025-09-17

Breaking Changes

  • view_datasets() was renamed to view_datasets_ColombiAPI() to avoid naming conflicts with other packages and improve function identification.

  • get_airports_list() was renamed to get_colombia_airports() to avoid naming conflicts with other packages and improve function identification.

  • get_Colombia_info() was renamed to get_country_info_co() to avoid naming conflicts with other packages and improve function identification.

  • get_country_info_co() Not only was the function name changed, but its data source also shifted from API-Colombia to the REST Countries API.

  • get_departments_list() was renamed to get_colombia_departments() to avoid naming conflicts with other packages and improve function identification.

  • get_presidents_list() was renamed to get_colombia_presidents() to avoid naming conflicts with other packages and improve function identification.

  • get_regions_list() was renamed to get_colombia_regions() to avoid naming conflicts with other packages and improve function identification.

New APIs added

New functions — API Colombia

New function — Nager.Date

New functions — World Bank API

ColombiAPI 0.1.1

CRAN release: 2025-02-16

Fixed function

ColombiAPI 0.1.0

CRAN release: 2025-01-09

Initial Release

  • First release of ColombiAPI package.
  • Added view_datasets() function to explore available datasets.
  • Collection of datasets that cover diverse aspects of Colombian society.
  • Initial API API Colombia – Added functions powered by API-Colombia