LoginSign Up
← Back to all sparks
G

gargle

DEVOPS
Velocity0.0

Shared infrastructure for Google API authentication and credential management in R

github.com/r-lib/gargle ↗

gargle rebuilt Google auth for R on httr2 and forced the whole wrapper stack to follow

oauthgoogle-apiscredentialshttr2tidyverse
◆Current state
gargle is the shared authentication layer under googledrive, googlesheets4, bigrquery and gmailr, which makes its interface decisions everyone else's migration work. The 1.5.0 release completed the OAuth app-to-client rename and replaced the internal secret handling with exported, httr2-based functions; since then the work has been diagnostics — better retry messaging, escaped error details, and detecting Positron and VS Code alongside RStudio.
◆Where it's heading
The package keeps moving toward being debuggable in the environments R actually runs in now: server, Workbench, Colab, VS Code, and non-package projects that still need encrypted credentials. Recent releases export things that used to be internal — last response, last content, error subclasses — which points at wrapper packages needing more control over failure handling than gargle previously allowed.
◆Prediction
Expect further exports that let wrapper packages classify and surface Google API errors themselves, and continued detection work as new IDEs and hosted environments appear.

◆Recent moves

  1. 6mo ago

    Last response and content exported; error subclassing added

    Hands wrapper packages the diagnostic hooks gargle was keeping internal, plus an error_class argument so failures can be caught by subclass. Small surface, aimed squarely at downstream maintainers.

    View source ↗
  2. 11mo ago

    Retry messaging, safer error details, Positron detection

    Retries now count down and explain what failed, Google-supplied error text is escaped so cli stops choking on braces, and gargle recognizes Posit Workbench outside RStudio. Continues the debuggability arc.

    View source ↗
  3. 3y ago

    Service account input validation fixed

    An internal helper correction for a common mix-up between OAuth client JSON and service account JSON.

    View source ↗
  4. 3y ago

    Leftover app-to-client work in out-of-band auth

    Finishes overlooked pieces of the rename and makes the secret_*() functions easier to find in documentation.

    View source ↗
  5. 3y ago

    Secret handling rebuilt on httr2; OAuth client rename completed

    ⚡ SPARK

    The release the rest of the tidyverse Google stack had to synchronize with — googledrive's own notes cite it explicitly. Exported httr2-based secret functions replace the internal ones, and the app-to-client terminology change lands across arguments, fields and methods.

    View source ↗
  6. 3y ago

    GCE credential diagnostics and OAuth client type detection

    Strengthens the pull toward the cloud-platform scope, reports scope mismatches under debug verbosity, and adds gargle_oauth_client_type() so server and Colab environments get the pseudo-OOB flow automatically.

    View source ↗