teamdigitale / api-starter-kit-rust

Experimental api-starter-kit in RUST

WIP Starter kit per la pubblicazione di API interoperabili in rust

Questo repository conterrà il template di un'API interoperabile scritta in rust.

Contenuto

• Un progetto di esempio in rust
• Una directory openapi con le specifiche

Istruzioni

Gli step per la creazione di API interoperabili sono:

1. scrivere le specifiche in formato OpenAPI v3 partendo dagli esempi in openapi;

2. scrivere o generare il codice a partire dalle specifiche. Il generatore di codice non funziona ancora correttamente.

3. scrivere i metodi dell'applicazione

Scrivere le specifiche

Le specifiche devono essere scritte in formato OpenAPIv3 e rispettando le Linee Guida di interoperabilità.

Queste presentazioni possono essere d'aiuto:

• Introduzione ad OpenAPI
• REST nel nuovo modello di interoperabilità

Risolvere le dipendenze negli OpenAPI

Le specifiche OpenAPI possono contenere riferimenti a schemi esterni o yaml anchors. E' possibile risolverli tramite il modulo rust openapi_resolver, richamato dal Makefile.

In questo repository, i file con anchor e ref hanno estensione .yaml.src ma sono a tutti gli effetti file OAS3 validi e la maggior parte dei tool li interpreta correttamente. E' comunque possibile dereferenziarli per comodità tramite il comando:

make yaml

Generare il codice del server

Il Makefile contiene:

• un esempio di code generation rust direttamente via openapi v3. Basta lanciare:

  make rust-generate 
  

Il codice generato è basato su una vecchia versione di openssl e non compila correttamente. Va' corretto il codice del generatore o individuato un generatore funzionante.

Dipendenze

Per eseguire questa app servono:

make
rust 3 + tox
docker

Test

E' possibile testare in locale tramite circleci, con:

    circleci build