Package 'datafaro'

Title: Interact with the Datafaro API Seamlessly
Description: DataFaro offers access to recurrent data from a variety of sources. It abstracts concerns related to data frequency, format, and publication calendar. This package provides a convenient wrapper for interacting with the Datafaro API, making it easier for R users to harness the power of DataFaro.
Authors: Daniel E. de la Rosa [aut, cre] , Datafaro [cph]
Maintainer: Daniel E. de la Rosa <[email protected]>
License: CC BY 4.0
Version: 1.0.0
Built: 2024-11-12 03:55:35 UTC
Source: https://github.com/datafaro/datafaroR

Help Index


Convert a Datafaro's datalight list object to a datalight object

Description

Convert a Datafaro's datalight list object to a datalight object

Usage

as_datalight(data)

Arguments

data

A Datafaro's datalight list object

Value

a datalight object

Examples

## Not run: 
  .res <- list(
      data = mtcars,
       dictionary = list(),
       metadata = list(next_update = Sys.Date() + 30),
       cached = Sys.Date(),
       slug = "mtcars"
     )
  mi_tibble <- as_datalight(.res)
  print(mi_tibble)

## End(Not run)

Autenticar y obtener token de acceso

Description

Esta función verifica si existe información de autenticación previa almacenada y válida. Si no encuentra información válida o el token ha expirado, solicita al usuario que se autentique nuevamente. Si la autenticación es exitosa, genera y almacena un nuevo token de acceso para solicitudes futuras. En caso de encontrar un token válido y no expirado, lo retorna para su uso inmediato.

Usage

auth(scope = "user")

Arguments

scope

character Alcance de la autenticación. Por defecto es "user". Opciones válidas son "user" y "project". "user" estará disponible para todas las sesiones de R, mientras que "project" solo estará disponible para las sesiones de R en el proyecto actual.

Value

Retorna el token de acceso si la autenticación es exitosa o el token almacenado sigue siendo válido. En otros casos, guía al usuario para realizar una nueva autenticación.

Examples

## Not run: 
auth() # Ejecuta esta funci\u00f3n para autenticarte o validar el token existente.

## End(Not run)

Obtener la última actualización de un conjunto de datos de Datafaro

Description

[Experimental]

Usage

get_data(code, .token = auth(), .cached = TRUE)

Arguments

code

character Código del conjunto de datos

.token

character Token de acceso a la API. Si no se ha guardado un token, se debe especificar el token manualmente.

.cached

logical Si se debe utilizar la caché. Por defecto es TRUE.

Value

Un datalight con la última actualización del conjunto de datos.

Examples

## Not run: 
get_data("NC_XDC")

## End(Not run)

Cerrar sesión y eliminar el token de acceso

Description

Esta función elimina la información de autenticación almacenada para el alcance especificado, efectivamente cerrando la sesión del usuario. Esto es útil para garantizar que la información sensible no permanezca accesible en sesiones no autenticadas posteriormente.

Usage

log_out(scope = "user")

Arguments

scope

character Alcance de la autenticación para la que se desea cerrar sesión. Por defecto es "user". Las opciones válidas son "user" y "project". "user" afecta todas las sesiones de R, mientras que "project" solo afecta a la sesión de R en el proyecto actual.

Value

No retorna valores. Invoca un mensaje que informa al usuario que la sesión ha sido cerrada correctamente.

Examples

## Not run: 
log_out() # Ejecuta esta funci\u00f3n para cerrar la sesión y eliminar el token de acceso.

## End(Not run)

Print a datalight object

Description

Print a datalight object

Usage

## S3 method for class 'datalight'
print(x, ...)

Arguments

x

A Datafaro's datalight json object

...

Other arguments passed on to methods

Value

a print of the object. Invisible x

Examples

## Not run: 
  .res <- jsonlite::toJSON(
      list(
          data = mtcars,
          dictionary = list(),
          metadata = list(next_update = Sys.Date() + 30),
          cached = Sys.Date(),
          slug = "mtcars"
       )
   )
  mi_tibble <- as_datalight(.res)
  print(mi_tibble)

## End(Not run)