npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@gatsbyjs/relay-compiler

v2.0.0-printer-fix.4

Published

A compiler tool for building GraphQL-driven applications.

Downloads

15,305

Readme

Relay Compiler

Relay-Compiler is a code-generation toolkit for GraphQL. It contains the core functionalities of GraphQL code-gen, including file parsing, validation, syntax tree parsing and transformation.

The GraphQL-Compiler package exports library code which you may use to find the modules you need, or to extend the compiler with your own custom input and output. Note, the internal APIs of the GraphQL-Compiler are under constant iteration, so rolling your own version may lead to incompatibilities with future releases.

The following graph illustrates the high-level architecture of a complete GraphQL code-generation pipeline:

CodegenPipeline

To understand the underlying workflow of the core compilation step, which is what happens in the "GraphQL Compiler" block in the above graph, please refer HERE.

You can build your own version of the Compiler by adding your own FileWriter, and by swapping or adding a FileParser and additional IRTransforms (IR, which stands for Intermediate Representation, a special-purpose syntax tree format designed for transformability).

  • The GraphQL-Compiler package provides a GraphQLFileParser, which can be used to parse general .graphql files, and a GraphQLTextParser, which can be used to parse GraphQL text in any source files with customized tags. You can also write your own FileParser at your discretion.

  • You can add additional IRTransforms by extending the basic GraphQLIRTransforms. A sample can be found HERE.

  • Similarly, you can add additional validation rules by extending the basic GraphQLValidator. Sample HERE.

  • A sample FileWriter can be found HERE.

To actually run your compiler, you will also need a script to assemble all the above components. A sample file can be found HERE.