search

eminetto / eltonminetto.dev

Repositório com os comentários do eltonminetto.dev
3 stars 0 forks source link

Introdução ao TypeSpec #29

Open utterances-bot opened 1 week ago

utterances-bot commented 1 week ago

Introdução ao TypeSpec

Vou começar esse post com um pouco de história. Lá pelo começo da década de 2010, o hype do momento era o conceito de APIs e API-first.

https://eltonminetto.dev/post/2024-10-12-intro-to-typespec/

adnux commented 1 week ago

Achei bem interessante o projeto e como ele simplifica a criação e depois a emissão em outro formato, porém não ficou claro pra mim como isso é consumido? Com swagger era feito o setup e depois anotados os endpoints pra criar a doc, mas com typespec como isso funciona? A especificvação acompanha a evolução da aplicação?

eminetto commented 1 week ago

@adnux na minha opinião a ideia é usar o TypeSpec na fase de especificação e design da API, como ferramenta para facilitar a discussão e definição. Com essa etapa finalizada (a cada nova feature por exemplo) pode-se usar uma pipeline de CI/CD para gerar os artefatos em OpenAPI, Protobuf ou outro formato desejado.

Quanto a

A especificvação acompanha a evolução da aplicação?

Eu vejo que sim. O time deveria atualizar o TypeSpec sempre que uma nova feature ou mudança é feita na aplicação