Skip to content

cult-of-coders/grapher

Repository files navigation

Introducing BlueLibs

Grapher 1.5

Grapher is a Data Fetching Layer on top of Meteor and MongoDB. It is production ready and battle tested. Brought to you by Cult of Coders — Web & Mobile Development Company.

Main features:

  • Innovative way to make MongoDB relational
  • Blends in with Apollo GraphQL making it highly performant
  • Reactive data graphs for high availability
  • Incredible performance
  • Denormalization ability
  • Connection to external data sources
  • Usable from anywhere

It marks a stepping stone into evolution of data, enabling developers to write complex and secure code, while maintaining the code base easy to understand.

Read more about the GraphQL Bridge

Installation

meteor add cultofcoders:grapher

This provides a learning curve for Grapher and it explains all the features. If you want to visualize the documentation better, check it out here:

https://cult-of-coders.github.io/grapher/

Grapher cheatsheet, after you've learned it's powers this is the document will be very useful.

Useful packages

Events for Meteor (+ Grapher, Redis Oplog and GraphQL/Apollo)

  • Meteor Night 2018: Arguments for Meteor - Theodor Diaconu, CEO of Cult of Coders: “Redis Oplog, Grapher, and Apollo Live.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

Quick Illustration

Query:

createQuery({
    posts: {
        title: 1,
        author: {
            fullName: 1,
        },
        comments: {
            text: 1,
            createdAt: 1,
            author: {
                fullName: 1,
            },
        },
        categories: {
            name: 1,
        },
    },
}).fetch();

Result:

[
    {
        _id: 'postId',
        title: 'Introducing Grapher',
        author: {
            _id: 'authorId',
            fullName: 'John Smith
        },
        comments: [
            {
                _id: 'commentId',
                text: 'Nice article!,
                createdAt: Date,
                author: {
                    fullName: 1
                }
            }
        ],
        categories: [ {_id: 'categoryId', name: 'JavaScript'} ]
    }
]

Testing

You can create test directory and configure dependencies (working directory is the root of this repo):

# create meteor app for testing
# you can add a specific release with --release flag, this will just create the app with the latest release
meteor create --bare test 
cd test
# install npm dependencies used for testing
meteor npm i --save [email protected] [email protected] [email protected] chai

# Running tests (always from ./test directory)
METEOR_PACKAGE_DIRS="../" TEST_BROWSER_DRIVER=chrome meteor test-packages --once --driver-package meteortesting:mocha ../

If you use TEST_BROWSER_DRIVER=chrome you have to have chrome installed in the test environment. Otherwise, you can just run tests in your browser.

Another option is to use puppeteer as a driver. You'll have to install it with meteor npm i puppeteer@10. Note that the latest versions don't work with Node 14.

With --port=X you can run tests on port X.

Omit --once and mocha will run in watch mode.