Releasing v0.4.0 #540

jondot · 2024-04-16T08:04:31Z

jondot
Apr 16, 2024
Maintainer

We're releasing 0.4.0, for which the central focus was supporting multiple format responses in the same endpoint handler (i.e. returning different types). One important use case is returning JSON for `accept: application/json` and HTML for its relevant mime types.

One challenge was: how would the developer experience look like?

In Rails and Ruby it looks like this, very clean, due to lots of magic:

  def index
    @people = Person.find(:all)

    respond_to do |format|
      format.html
      format.xml { render :xml => @people.to_xml }
    end
  end

After a few iterations, we've come to shape it into this in Rust:

pub async fn get_one(
    Format(respond_to): Format,
    Path(id): Path<i32>,
    State(ctx): State<AppContext>,
) -> Result<Response> {
    let item = load_item(&ctx, id).await?;
    match respond_to {
        RespondTo::Html => format::html(&format!("<html><body>{:?}</body></html>", item.title)),
        _ => format::json(item),
    }
}

Taking advantage of axum extractors, we're using Format to say "this is a responder type endpoint" and then using match to immitate Ruby's blocks aesthetics.

Another DX improvement we made is for model validations, all you need is to implement Validatable now:

impl Validatable for super::_entities::users::ActiveModel {
    fn validator(&self) -> Box<dyn Validate> {
        Box::new(Validator {
            name: self.name.as_ref().to_owned(),
            email: self.email.as_ref().to_owned(),
        })
    }
}

// now you can call `user.validate()` freely

get started: https://loco.rs/docs/getting-started/tour/

repo: https://github.com/loco-rs/loco

0.4.x changelog: CHANGELOG.md

Thanks @haoxins @RobertChang0722 @yinho999 @didy-kpn @clefelhocz2 @PolpOnline @AndreiOrmanji @spencewenski @assapir for participating in this release!

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Releasing v0.4.0 #540

{{title}}

Replies: 0 comments

Select a reply

Releasing v0.4.0 #540

jondot Apr 16, 2024 Maintainer

Replies: 0 comments

jondot
Apr 16, 2024
Maintainer