graphql.macro

> Compile GraphQL AST at build-time with babel-plugin-macros.

[![Travis][build-badge]][build]
[![Codecov Status][codecov-badge]][codecov]
[![npm package][npm-badge]][npm]
[![npm downloads][npm-downloads]][npm]

[![prettier][prettier-badge]][prettier]
[![license][license-badge]][license]

Installation

``sh
$ yarn add graphql.macro
`

_Note: You'll need to install and configure babel-plugin-macros if you haven't already._

Example

evenchange4/graphql.macro-example (with react-script@2.x) [DEMO]

Usage

$3

`js
import { loader } from 'graphql.macro';
const query = loader('./fixtures/query.graphql');

↓ ↓ ↓ ↓ ↓ ↓

const query = {
"kind": "Document",
"definitions": {
...
`

$3

`diff
-import gql from 'graphql-tag';
+import { gql } from 'graphql.macro';

const query = gql
query User {
user(id: 5) {
lastName
...UserEntry1
}
}
;

↓ ↓ ↓ ↓ ↓ ↓

const query = {
"kind": "Document",
"definitions": [{
...
`

Alternative

- [Webpack preprocessing with graphql/loader
- Babel preprocessing
- https://github.com/leoasis/graphql-tag.macro

Development

$3

- node >= 11.10.0
- yarn >= 1.13.0

`sh
$ yarn install --pure-lockfile
`

Test

`sh
$ yarn run format
$ yarn run eslint
$ yarn run flow
$ yarn run test:watch
$ yarn run build
`

Publish

`bash
$ npm version patch
$ npm run changelog
git commit & push
``

---

CONTRIBUTING

- ⇄ Pull requests and ★ Stars are always welcome.
- For bugs and feature requests, please create an issue.
- Pull requests must be accompanied by passing automated tests.

CHANGELOG

LICENSE

MIT: http://michaelhsu.mit-license.org

[build-badge]: https://img.shields.io/travis/evenchange4/graphql.macro/master.svg?style=flat-square
[build]: https://travis-ci.org/evenchange4/graphql.macro
[npm-badge]: https://img.shields.io/npm/v/graphql.macro.svg?style=flat-square
[npm]: https://www.npmjs.org/package/graphql.macro
[codecov-badge]: https://img.shields.io/codecov/c/github/evenchange4/graphql.macro.svg?style=flat-square
[codecov]: https://codecov.io/github/evenchange4/graphql.macro?branch=master
[npm-downloads]: https://img.shields.io/npm/dt/graphql.macro.svg?style=flat-square
[license-badge]: https://img.shields.io/npm/l/graphql.macro.svg?style=flat-square
[license]: http://michaelhsu.mit-license.org/
[prettier-badge]: https://img.shields.io/badge/styled_with-prettier-ff69b4.svg?style=flat-square
[prettier]: https://github.com/prettier/prettier