Microsoft har de siste årene jobbet med et nytt språk, TypeSpec, som ifølge selskapet selv kan "revolusjonere måten du driver API-utvikling" på.
Nå har Microsoft offisielt lansert språket, og gjort det til åpen kildekode.
TypeSpec er inspirert av TypeScript, som også er laget av Microsoft, og er ifølge Microsoft et "lettvekts-språk" som kan brukes til å beskrive API-er på en enklere måte.
Slipper å håndkode konfigurasjonsfiler
Mange bruker i dag OpenAPI til å beskrive REST API-er, men det å håndkode store og kompliserte konfigurasjonsfiler i YAML- eller JSON-format kan være ganske omstendelig.
Det er her TypeSpec kommer inn og skal gjøre jobben enklere for deg.
Etter at du har beskrevet API-et med TypeSpec, kan språket kompilere til OpenAPI, JSON Schema, Protobuf – eller alle tre samtidig.
Illustrasjonen under viser et eksempel på en TypeSpec-beskrivelse (til venstre) som kompileres til OpenAPI:
Ifølge Microsoft er TypeSpec ikke bare et språk, men en plattform for abstraksjon, og en plattform som gjør det enklere å gjenbruke kode.
Det er også tillegg for VS Code og Visual Studio som gir deg formatering og syntaks-utheving for TypeSpec i kodeeditoren.
Brukes av Microsoft
Microsoft bruker selv TypeSpec internt hos seg, blant annet i mange av tjenestene de tilbyr i Azure-plattformen.
– Ved å utnytte kraften i TypeSpec har Microsoft Graph-teamet revolusjonert API-utviklingen innenfor Microsoft. Dette samarbeidet har forbedret produktiviteten og forenklet tilpasning, noe som understreker TypeSpecs potensial, skriver selskapet.
TypeSpec er som nevnt åpen kildekode og ligger på GitHub.
Microsofts Mandy Whaley holdt nylig et foredrag på Austin API Summit der hun gikk igjennom TypeSpec og hvordan de bruker det nye språket selv internt: