mongoke
Project description
mongoke
Instantly serve your MongoDb database via graphql
Features
- Powerful Queries: Pagination, filtering, relation, relay-style connections built-in and generated in a bunch of seconds
- Works with existing databases: Point it to an existing MongoDb database to instantly get a ready-to-use GraphQL API
- Authorization via Jwt: Every collection can be protected based on jwt payload and document fields
- Horizontally Scalable: The service is completely stateless and can be replicated on demand
- Apollo Federation: The service can be easily glued with other graphql servers to handle writes and more complicated logic.
- Resilient Idempotent Configuration: One YAML Configuration as the only source of truth, relations, authorization and types in one file
Quickstart:
Using Docker compose
The fastest way to try Mongoke is via docker-compose.
1. Write the configuration to describe the database schema and relations
The ObjectId scalar is already defined by default, it is converted to string when sent as json
# ./mongoke.yml
schema: |
type User {
_id: ObjectId
username: String
email: String
}
type BlogPost {
_id: ObjectId
author_id: ObjectId
title: String
content: String
}
types:
User:
collection: users
BlogPost:
collection: posts
relations:
- field: posts
from: User
to: BlogPost
relation_type: to_many
where:
author_id: ${{ parent['_id'] }}
2. Run the mongoke
image with the above configuration
To start the container mount copy paste the following content in a docker-compose.yml
file, then execute docker-compose up
.
# docker-compose.yml
version: '3'
services:
mongoke:
ports:
- 4000:80
image: mongoke/mongoke
environment:
DB_URL: mongodb://mongo/db
volumes:
- ./mongoke.yml:/conf.yml
mongo:
image: mongo
3. Query the generated service via graphql or go to http://localhost:4000/graphiql to open graphiql
{
User(where: { username: { eq: "Mike" } }) {
_id
username
email
posts {
nodes {
title
}
}
}
BlogPostNodes(first: 10, after: "Post 1", cursorField: title) {
nodes {
title
content
}
pageInfo {
endCursor
hasNextPage
}
}
}
Tutorials
Check out the /examples directory in this repo
Please help the project making new tutorials and submit a issue to list it here!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mongoke-1.4.3.tar.gz
(16.9 kB
view details)
File details
Details for the file mongoke-1.4.3.tar.gz
.
File metadata
- Download URL: mongoke-1.4.3.tar.gz
- Upload date:
- Size: 16.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2a0917c05846aea049f61d261690c374978b4bb81f6d12319c6d70cad33988f1 |
|
MD5 | 71f4370adc5dad2ad7faf685cb5b8c2f |
|
BLAKE2b-256 | 4d388912543dab4bcc5e41f29e7e68b0ac4b32579e038f9a30223e2a2eadafb9 |