Skip to content

cult-of-coders/grapher

Folders and files

NameName
Last commit message
Last commit date
Mar 11, 2024
Feb 22, 2022
Sep 27, 2018
Nov 23, 2023
Mar 4, 2024
Oct 24, 2023
Mar 11, 2024
Mar 11, 2024
Nov 26, 2017
Aug 12, 2018
Oct 25, 2023
Mar 29, 2018
May 9, 2019
Apr 6, 2022
Mar 11, 2024
Sep 29, 2022
Sep 21, 2018

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 selenium-webdriver@3.6.0 chromedriver@2.36.0 simpl-schema@1.13.1 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.

About

Grapher: Meteor Collection Joins + Reactive GraphQL like queries

Topics

Resources

License

Stars

Watchers

Forks

Contributors 23