Provide actix-web v4 doc or migration guide #2170
Replies: 1 comment 5 replies
-
|
Providing a migration guide is the plan. Before the stable release we'll collate the most impactful changes from the changelog and expand on them in MIGRATION.md. |
Beta Was this translation helpful? Give feedback.
-
|
How long is it estimated? I plan to use v4 in a new project, but there is no related documentation and I don’t know how to start. |
Beta Was this translation helpful? Give feedback.
-
|
From what I see all docs are built properly. Is this not work for you? https://docs.rs/actix-web/4.0.0-beta.6/actix_web/index.html Most of the break changes can be found in CHANGES.md and you would want to couple with docs.rs to figure out the changes. betas contains incremental break changes so provide a migration guide early could be more work to do and further delay the stable release. |
Beta Was this translation helpful? Give feedback.
-
|
@fakeshadow Thanks.
I am familiar with v3, but not familiar with the changes of v4. Without documentation, I can only find and debug without a clue, which is very inefficient.
Yeah, Maybe you don’t need to write detailed documents, but you can list some simple examples that you use in your tests. Thank you for your efforts. 🍻 Looking forward to the early release of v4. |
Beta Was this translation helpful? Give feedback.
-
I didn't make changes to it so I'm not sure what's the case on
Yea I would like to do add examples on new features and changes but still get some other issues not figured out for next release(Possibly).
You are welcome. Sorry for keep you waiting we want to make it right and ready and possibly keep v4 stable for a much longer time than v3. |
Beta Was this translation helpful? Give feedback.
-
I don't know, but I got a error prompt in v4: impl actix_web::ResponseError for ServerError {
fn error_response(&self) -> web::HttpResponse {
// todo
}
// pub struct Response<B>
// An HTTP response.
// missing generics for struct `actix_web::BaseHttpResponse`
// expected 1 type argument
// help: use angle brackets to add missing type argument: `<B>`
}After changing to the following, it runs normally: use actix_web::{ web, http };
use actix_http::{body::Body, http::HeaderValue, http::StatusCode};
...
impl actix_web::ResponseError for ServerError {
fn error_response(&self) -> web::HttpResponse<Body> { // change
// todo
}
}There are other changes, and I am still exploring it.
I am looking forward. 👏 |
Beta Was this translation helpful? Give feedback.
-
I am starting a new actix project, but the v4 version seems to have major changes, so in order to avoid possible migration risks, I want to start with v4.
Hope team can provide v4 documentation or migration guide.
Beta Was this translation helpful? Give feedback.
All reactions