typespec-todo
typespec | typespec-todo | |
---|---|---|
8 | 2 | |
3,064 | 5 | |
26.7% | - | |
9.7 | 7.9 | |
3 days ago | 2 months ago | |
TypeScript | TypeScript | |
MIT License | - |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
typespec
-
Write OpenAPI with TypeSpec
It does not exist, but it will be worked on fairly soon. You can track progress on GitHub [1]. It will be as you suggest - a one time conversion, after which you can iterate. We have this workflow for inside Azure, but the converter is Azure-specific (e.g. converts to TypeSpec that uses our extensive Azure-specific component library). It will take a bit to generalize.
[1]: https://github.com/microsoft/typespec/issues/3038
- TypeSpec
-
Write SDK “base” in Rust, wrap in other languages?
Afaik there's nothing that's widely used and of which I'd say I prefer it. But I'm having hopes for https://github.com/microsoft/typespec (former cadl). The reason being that yaml/JSON specs get huge very quickly, OpenAPI has to fight with restrictions of yaml/JSON ($refs, splitting up into files, oneOf, etc.) and tooling is ok but not great.
-
Ask HN: Why is there no specification for Command Line Interfaces?
You've touched on some use cases I've thought about and led me to ask the question.
I also recently saw Microsoft take a higher level approach with CADL/Typespec: https://microsoft.github.io/typespec/ which could be cool if it reaches wide adoption.
- Cadl
- Cadl: a language to describe APIs and generate schemas
- Cadl: A language to describe APIs and generate schemas
-
Cadl: a new IDL
This one just crossed my feed today: Cadl, "... a language for describing cloud service APIs and generating other API description languages, client and service code, documentation, and other assets."
typespec-todo
-
Write OpenAPI with TypeSpec
TypeSpec and Smithy live in a similar space here. You can generate OpenAPI specs from them, or you can generate assets directly from them. OpenAPI is one of the many possible outputs from TypeSpec.
This is an example the author created of TypeSpec being used to generate clients in many languages as well as the OpenAPI spec.
https://github.com/bterlson/typespec-todo
What are some alternatives?
guardrail - Principled code generation from OpenAPI specifications
libninja - Generate client libraries that are featureful, human, well-documented, and async based on OpenAPI specs
core-crypto - MLS/Proteus multiplexer abstraction with encrypted persistent storage in Rust
rutie - “The Tie Between Ruby and Rust.”
connexion - Connexion is a modern Python web framework that makes spec-first and api-first development easy.
wasmer - 🚀 The leading Wasm Runtime supporting WASIX, WASI and Emscripten
vcr - Record your test suite's HTTP interactions and replay them during future test runs for fast, deterministic, accurate tests.
cli-guidelines - A guide to help you write better command-line programs, taking traditional UNIX principles and updating them for the modern day.
uniffi-rs - a multi-language bindings generator for rust
nballerina - Ballerina compiler that generates native executables.
jsii - jsii allows code in any language to naturally interact with JavaScript classes. It is the technology that enables the AWS Cloud Development Kit to deliver polyglot libraries from a single codebase!
cobra - A Commander for modern Go CLI interactions