mhs

mhs

Hi all,

I want to share Googly, a code generator that turns a Google API’s Discovery document into a ready-to-use Elixir client.

It’s inspired by googleapis/elixir-google-api, now deprecated and unmaintained, which pioneered the Google Discovery-doc → structs → templates approach. Googly keeps that idea but rebuilds the output for a modern stack.

What’s different

Google’s generated clients still work, but they’re starting show their age. Googly takes a different tack:

  • Req and Jason, nothing else. Modern HTTP and JSON.
  • Self-contained clients. Each package vendors its own ~150-line runtime and depends only on :req + :jason, so every client publishes to Hex independently.
  • A flat, stateless API. No Connection struct, no nesting. It’s just Googly.CloudStorage.Objects.get(bucket, object, token: token).
  • snake_case fields, exact wire names. Fields read like Elixir (bucket.time_created) while the exact JSON key (timeCreated) is baked in per field.
  • Plain structs. Each model is a defstruct with a macro-free decode/1, plus one Jason.Encoder that drops nils so PATCH won’t clobber unset fields.

The clients we have published in Hex as of today:

  • googly_cloud_storage — read, write, and manage objects and buckets.
  • googly_cloud_vision — send an image and get back OCR text, labels, and other analysis.
  • googly_document_ai — send a document and get back parsed text, fields, and entities.

Want another API? Holler. We can generate it and publish to Hex.

Or, if you prefer to vendor privately, list it in config/apis.json and run the generator.

Cheers.

Showing Posts 1 to 2

felix-starman

felix-starman

Thank you. I was literally looking at doing something like this for waffle_gcs. google_gax has been the bane of its dependency list for years.

Any particular plans to make Jason or the http client configurable with those as default implementations?

Are you all open to that as a contribution if I added it?

mhs

mhs OP

Hey Felix! Happy to chat through what you’re thinking, if you want to toss up an issue in the repo.

— All posts loaded —

Where Next? Top

Trending in Announcing Top

woylie
Flop is an Elixir library that applies filtering, ordering and pagination parameters to your Ecto queries. offset-based pagination with...
New
MRdotB
I needed to reuse React components from my Chrome extension in my Phoenix/LiveView backend. I noticed that for Svelte/Vue, there are live...
New
woylie
I released Doggo, a collection of unstyled Phoenix components. https://github.com/woylie/doggo Features Unstyled Phoenix components....
New
JesseHerrick
Hey, I’m Jesse and I’m the main contributor behind Dexter, a full-featured, lightning-fast Elixir LSP optimized for large codebases. It s...
New
marciok
Hi there! We created Gust: A task orchestrator inspired by Airflow. For those who have never heard about Aiflow, it’s a Python-based wor...
New
anuaralfetahe
Hello Published a new library - ProcessHub! ProcessHub is a library designed to manage process distribution within the Elixir cluster. ...
New
jimsynz
Beam Bots (or just BB for short) is a framework for building fault-tolerant robotics applications in Elixir using familiar OTP patterns. ...
New

Other Trending Topics Top

mudasobwa
I am happy to introduce the very α version of the new programming language compiled to BEAM. Welcome Cure. It has literally three kille...
New
mhanberg
Hi everyone! The first release candidate for the Expert language server project is now available! We’ve published a press release detai...
New
webofbits
With AI doing more of the implementation work, I’ve been wondering how much coding I should deliberately keep doing myself. My main conc...
#ai
New
sergio
It’s not that it’s vocabulary is too advanced. It’s something worse. I get lost trying to follow even a paragraph written by Claude. It’...
New
AstonJ
This showed up on my feed.. anyone heard of it? Just hype? Ox Alpha is a reasoning model designed for coding, sustained ag...
New
bartblast
Hey folks, I just published a post about Hologram’s funding and where the project goes next - the short version: Curiosum as Main Spons...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews