In nbc/didoscalim: Charger des données dans DiDo

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)

library(didoscalim)

Les environnements DiDo

Les données publiées sur l'environnement de production de DiDo (PROD) sont immédiatement mis en ligne et disponibles sur internet.

Pour tester vos jeux de données, il est recommander d'utiliser un environnement ECOLE en amont de la publication officielle. Cet environnement permet de valider :

• le chargement proprement dit
• les métadonnées associées
• la qualité statistique

Configuration

Les environnements se configurent dans le fichier .Renviron.

Chaque environnement est configuré par deux lignes comme celles-ci :

DIDOSCALIM_BASE_PATH_<NOM_ENVIRONNEMENT>=http://api.alimentation.ecole.fr/v1
DIDOSCALIM_API_KEY_<NOM_ENVIRONNEMENT>=<CLEF_API>

• <NOM_ENVIRONNEMENT> peut prendre les valeurs DEV, PREPROD, ECOLE et PROD
• <CLEF_API> est disponible dans l'interface d'alimentation DiDo dans la rubrique « Mon compte ».

Si vous êtes un producteur et que vous avez accès aux environnements ECOLE et PROD, votre fichier .Renviron ressemblera à :

DIDOSCALIM_BASE_PATH_ECOLE=http://api.alimentation.ecole.fr/v1
DIDOSCALIM_API_KEY_ECOLE=ma_clef_api_ecole

DIDOSCALIM_BASE_PATH_PROD=http://api.alimentation.prod.fr/v1
DIDOSCALIM_API_KEY_PROD=ma_clef_api_prod

Pour le modifier vous pouvez utiliser les commandes suivantes :

library(devtools)
usethis::edit_r_environ()
readRenviron("~/.Renviron")
library(didoscalim)
load_envs()
check_envs()

Choisir un environnement

Si vous ne sélectionnez pas d'environnement, DiDo prendra automatiquement par défaut le premier configuré dans l'ordre : DEV, PREPROD, ECOLE. Il ne choisira jamais PROD implicitement.

Pour sélectionner un environnement, utilisez la commande set_work_env() :

set_work_env("PROD")

Pour revenir à l'environnement par défaut :

set_work_env()

Vous pouvez à tout moment voir dans quel environnement vous êtes avec la commande get_work_env().

Vous pouvez lister les environnements configués avec la commande list_envs() :

list_envs()

et vérifier qu'ils fonctionnent avec la commande check_envs() :

check_envs()

Méthode d'alimentation

Écrivez et testez vos scripts dans l'environnement ECOLE par défaut. Quand vous êtes satisfait du résultat, basculer sur l'environnement de PROD et relancez les scripts.

nbc/didoscalim documentation built on Sept. 12, 2022, 10:17 a.m.