poem
typespec | poem | |
---|---|---|
8 | 30 | |
3,064 | 3,226 | |
26.7% | 2.6% | |
9.7 | 8.8 | |
2 days ago | 7 days ago | |
TypeScript | Rust | |
MIT License | Apache License 2.0 |
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."
poem
-
Write OpenAPI with TypeSpec
TypeSpec is great, but if you're working with Rust and you're about to write a new project that will require an OpenApi spec sooner or later, I'd like to recommend a web framework that has spec generation baked in:
https://github.com/poem-web/poem (see poem_openapi)
All you need to do is derive a trait on your response structs and in return you get an almost perfectly generated spec. Unions, objects, enums are first class citizens.
Also, if you're from coming from PHP, the controllers feel very much like symfony controllers.
P.s. Please do recommend an ORM that would feel closer to doctrine. I miss doctrine.
-
What is the best API generator for Axum?
I've used FastAPI/Pydantic before as well and it was a very good experience. It has been a while since I used them though, so I forget exactly how they compare, but I do recall it wrote most of the OpenAPI spec. for you. I will also agree when I saw utoipa and aide they seemed to require more boilerplate even though I have not done an actual comparison. Poem, on the other hand, seems very neat and clean and doesn't have any duplication that I can see. Here is the [TODO example](https://github.com/poem-web/poem/blob/master/examples/openapi/todos/src/main.rs).
-
Looking for a Rust API with automatic documentation and good validation?
The example at https://github.com/poem-web/poem/tree/master/examples/openapi/auth-apikey works without issues for me.
-
What library to use for a Websocket Server?
'Poem', it turns to nicer to play with for me than 'Axum'. Example of web socket chat https://github.com/poem-web/poem/blob/master/examples/poem/websocket-chat/src/main.rs
-
Rest API framework in rust
If you need built-in OpenAPI support, I can recommend Poem.
-
(Recommendation Request) Rust REST API framework; similar to Python's FastAPI(Python)
If OpenAPI is important, then you may to consider https://github.com/poem-web/poem instead of axum. It isn't nearly as widely used, but it should still be compatible with everything else.
-
Hey Rustaceans! Got a question? Ask here (3/2023)!
Poem: More rigid and less popular and aims to be easier https://github.com/poem-web/poem
-
A taste of pavex, an upcoming Rust web framework
Did you check out Poem? It seems promising, with openapi generation built in already.
-
I switch from Golang and want to build a REST API in Rust.
https://github.com/poem-web/poem is a pretty nice framework
-
Migrating from warp to axum
I recently been working with warp and stumbled upon poem framework (https://github.com/poem-web/poem), any thoughts about that? Considering Axum as well but staying a bit on cautionary side until 0.6 full release.
What are some alternatives?
guardrail - Principled code generation from OpenAPI specifications
axum - Ergonomic and modular web framework built with Tokio, Tower, and Hyper
libninja - Generate client libraries that are featureful, human, well-documented, and async based on OpenAPI specs
Rocket - A web framework for Rust.
core-crypto - MLS/Proteus multiplexer abstraction with encrypted persistent storage in Rust
jelly-actix-web-starter - A starter template for actix-web projects that feels very Django-esque. Avoid the boring stuff and move faster.
rutie - “The Tie Between Ruby and Rust.”
async-graphql - A GraphQL server library implemented in Rust
connexion - Connexion is a modern Python web framework that makes spec-first and api-first development easy.
okapi - OpenAPI (AKA Swagger) document generation for Rust projects
wasmer - 🚀 The leading Wasm Runtime supporting WASIX, WASI and Emscripten
actix-web - Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust.