mhs
Googly - modern, self-contained clients for any Google API
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
PATCHwon’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.
First Post!
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?
Most Liked
mhs
Hey Felix! Happy to chat through what you’re thinking, if you want to toss up an issue in the repo.
Popular in Announcing
Other popular topics
Categories:
Sub Categories:
Forums
Popular Tags
- #ecto
- #liveview
- #troubleshooting
- #learning-elixir
- #deployment
- #library
- #erlang
- #testing
- #genserver
- #mix
- #absinthe
- #remote-other
- #otp
- #plug
- #how-to-question
- #macros
- #postgres
- #channels
- #elixirconf
- #exunit
- #discussion
- #code-sync
- #javascript
- #podcasts
- #onsite
- #dialyzer
- #docker
- #authentication
- #umbrella
- #full-time-contract
- #podcasts-by-brainlid
- #ecto-query
- #elixir-ls
- #phoenix_html
- #iex
- #blog-post
- #graphql
- #genstage
- #ai
- #websockets
- #supervisor
- #elixirconf-us
- #advent-of-code
- #distillery
- #processes
- #api
- #forms
- #metaprogramming
- #security
- #hex









