graphql.macro.vl

graphql.macro

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

Installation

$ yarn add graphql.macro

Note: You'll need to install and configure babel-plugin-macros if you haven't already. (This can be omitted when using CRA react-script@2.x .)

Example

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

Usage

loader

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

      ↓ ↓ ↓ ↓ ↓ ↓

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

gql

-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

Requirements

• node >= 9.4.0
• yarn >= 1.3.2

$ yarn install --pure-lockfile

Test

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

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

Changelog

<small>1.0.2 (2018-01-25)</small>

• fix(dependency): pinOnlyDevDependencies (5d6f320)
• 1.0.2 (123aef9)
• chore(deps): update dependency eslint-plugin-flowtype to v2.41.1 (#7) (e4bc70e), closes #7
• chore(deps): update dependency flow-bin to v0.64.0 (#8) (4cf17dd), closes #8
• docs(CHANGELOG): release 1.0.1 (78a7050)