asbru 0.0.12

A Data-oriented service mesh generator
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
114
115
116

Asbru - A Data-oriented Service Mesh
====

<div align="center">
  <!-- CI -->
  <img src="https://github.com/Miaxos/asbru/actions/workflows/ci.yml/badge.svg" />
  <!-- Crates version -->
  <a href="https://crates.io/crates/asbru">
    <img src="https://img.shields.io/crates/v/asbru.svg?style=flat-square"
    alt="Crates.io version" />
  </a>
  <!-- Documentation -->
  <a href="https://docs.rs/asbru/">
    <img src="https://docs.rs/asbru/badge.svg?style=flat-square"
      alt="Documentation" />
  </a>
  <!-- Downloads -->
  <a href="https://crates.io/crates/asbru">
    <img src="https://img.shields.io/crates/d/asbru.svg?style=flat-square"
      alt="Download" />
  </a>
</div>
<br />
<br />

/!\ WIP: Asbru won't be usable until version 0.1.0 /!\
/!\ The target is to have a MVP right now, so the code might be ugly sometimes, it's on purpose to create a prototype first. /!\

`Asbru` is an `async_graphql` Data-oriented Service Mesh generator: it'll generate an `async_graphql` project from a schema with resolvers, dataloaders, data-transformation. It'll create a Data-oriented service mesh from your schema so you'll just have to describe your microservices with your described schema to have a Data-Oriented Service Mesh like Airbnb's.

`Asbru` will be able to send metrics to apollo studio, use dataloaders patterns, store cache data into an external datastorage, be served serverless and even more.

`Asbru` is an opensource project based on Viaduct, an Airbnb's project presented [here](https://www.youtube.com/watch?v=xxk9MWCk7cM).

- [Documentation](https://docs.rs/asbru/)

_Tested at Rust version: `rustc 1.53.0 (53cb7b09b 2021-06-17)`_

## Rendered GraphQL

The rendered code is split accros three folders following an architecture inspired by the Domain Driven Design with 3 layers:

```
| main.rs
| schema.rs
| application/
|   entity/entity.rs
|   entity/query.rs
|   entity/mutation.rs
| domain/
|   entity/entity.rs
| infrastructure/
|   http.rs
|   db.rs
|   ...
```

`infrastructure` will contains every code and definitions structuring the whole application, each files should describe a high-level API which abstract the implementation, in practise, it might be coupled with the implementation.
For instance, instead of using directly `reqwest` to do http call, we create a higher level API, which describe how to do a HTTP call, and we provide an implementation for it with `reqwest`.

`domain` will describe our domains data, which called are made to call an entity, the associated dataloaders.

`application` will describe entity with a GraphQL implementation to describe query, mutations, subscriptions.

## Example

An interactive example is available with this [configuration](https://github.com/Miaxos/Asbru/tree/main/example/test01).

Available schema here:

- [https://asbru-schema-01.herokuapp.com/graphql](https://asbru-schema-01.herokuapp.com/)

## Roadmap v0.1.0

* ✅ Manage a configuration files.
* ✅ Docker build
* ❌ Codegen a `async_graphql` layout
  - ✅ Object generation layout
  - ✅ Modfiles
  - ✅ Cargo
  - ✅ Rust types on GraphQL scalars
  - ✅ Enum
  - ✅ Simple Query
  - ❌ Interfaces
  - ❌ Union
  - ❌ Mutations
  - ❌ Connections
* ❌ Architecture & Connect to services with a directive (at Airbnb it's something like `@serviceBackedNode`).
  - ✅ serviceBackedQuery
  - ❌ serviceBackedNode
  - ❌ serviceBackedConnection

## Roadmap v1.0.0
- Infrastructure
  - ❌ Dataloaders
  - ❌ Intra-request cache
  - ❌ Tracing
  - ❌ Extensions (Apollo Studio)
- GraphQL
  - ❌ Subscriptions
- Directives
  - ❌ derivedField
- Transport
  - ❌ GRPC


## Crate features

No features right now, but soon.

## References

* [Viaduct presentation](https://www.youtube.com/watch?v=xxk9MWCk7cM)
* [GraphQL](https://graphql.org)
* [Async Graphql Crates](https://github.com/async-graphql/async-graphql)
* [Codegen for async_graphql](https://github.com/atsuhiro/codegen-for-async-graphql)