Grumble

A DSL for generating GraphQL queries

Status: beta

We use this in our tests at work to generate all the queries (because we outgrew string concatenation). I'm not sure I'd want to depend on it in production yet because it's hard to feel like it's had a proper stress testing.

Needs (better) tests and documentation.
Missing support for some things we don't use.

Usage

Add to your deps:

{:grumble, "~> 0.1.0"}

Simple example:

import Grumble
alias Grumble.PP

IO.puts(PP.to_string(
  query(
    params: [community_id: type!(:string)],
    fields: [
      field(
        :community,
        args: [community_id: var(:community_id)],
        fields: [:id, :name]
      )
    ]
  )
))

Output:

query($communityId: String!) {
  community(communityId: $communityId) {
    name
    id
  }
}

Guide

Most of the useful functions are in the Grumble module. From there you can read which arguments are understood by the relevant new function. We apologise for the poor documentation, please feel free to contribute better docs!

Contributing

Contributions are welcome, even just doc fixes or suggestions.

This project has adopted a Code of Conduct based on the Contributor Covenant. Please be nice when interacting with the community.

Copyright and License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0