devoyage-subgraph 0.0.15

Subgraph is a CLI that instantly generates a GraphQL API around Mongo, SQL, and HTTP APIs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

[service]
# This is the name of the service
name = "pets"

# This is a list of data sources used by the service
[[service.data_sources]]

# This is a data source that connects to a MongoDB instance
[service.data_sources.Mongo]
# This is the name of the data source
name = "mongo_1"
# This is the connection URI for the MongoDB instance
uri = "mongodb://users:users@127.0.0.1:27017/users"
# This is the name of the database in the MongoDB instance
db = "sun"

# This is another MongoDB data source using Mongo Atlas
[[service.data_sources]]
[service.data_sources.Mongo]
name = "mongo_2"
uri = "mongodb+srv://$MONGO_USER:$MONGO_PASS@cluster0.dog1234.mongodb.net/?retryWrites=true&w=majority"
db = "dogs"

# This is an HTTP data source connecting to an external API
[[service.data_sources]]
[service.data_sources.HTTP]
name = "todos"
url = "https://jsonplaceholder.typicode.com"

# This is the CORS configuration for the service
[service.cors]
allow_any_origin = true
allow_headers = ["Authorization", "Content-Type"]

[[service.cors.allow_methods]]
method = "POST"

# This is a list of entities used by the service
[[service.entities]]
name = "Person"

# This is the data source for the entity
[service.entities.data_source]
from = "mongo_1"
collection = "users"

# These are the fields of the entity
[[service.entities.fields]]
name = "_id"
scalar = "ObjectID"
required = true

[[service.entities.fields]]
name = "name"
scalar = "String"
required = true

[[service.entities.fields]]
name = "age"
scalar = "Int"
required = false

[[service.entities.fields]]
name = "married"
scalar = "Boolean"
required = true

# This is another entity
[[service.entities]]
name = "Dog"
[service.entities.data_source]
from = "mongo_2"
collection = "dogs"
[[service.entities.fields]]
name = "_id"
scalar = "ObjectID"
required = true
[[service.entities.fields]]
name = "name"
scalar = "String"
required = true
[[service.entities.fields]]
name = "breed"
scalar = "String"
required = true

# This is another entity
[[service.entities]]
name = "todo"
[service.entities.data_source]
from = "todos"
path = "/todos"
[service.entities.data_source.resolvers]
[service.entities.data_source.resolvers.find_one]
path = "/:id"
[service.entities.data_source.resolvers.find_many]
search_query = [["userId", ":userId"], ["completed", ":completed"], ["id", ":id"]]
[[service.entities.fields]]
name = "userId"
scalar = "Int"
required = true
[[service.entities.fields]]
name = "id"
scalar = "Int"
required = true
[[service.entities.fields]]
name = "title"
scalar = "String"
required = true
[[service.entities.fields]]
name = "completed"
scalar = "Boolean"
required = true