[REQ] [rust-axum] model documentation

[jacob-vincent-mink]

While working on my own spec with the beta rust-axum generator, I encountered lots of models generated that look like

pub struct ModelName(Box<serde_json::value::RawValue>)

Obviously, the struct is public but

1. The value inside is not
2. The value inside is opaque, especially in an AnyOf case

I actually came across similar structs in the examples:

openapi-generator/samples/server/petstore/rust-axum/output/openapi-v3/src/models.rs

Line 804 in 278d7ae

pub struct AnyOfHashMapObject(Box<serde_json::value::RawValue>);

I would appreciate someone explaining the right way to discriminate these structs into the real types.

This is a request for documentation on how to use generated models like this when implementing a server api with the rust-axum generated traits.

Closing this issue would mean that we (I, at least, have) sufficient documentation on implementing a server based on the rust-axum generator.

I considered filing this as a bug report as an alternative, but I do not know enough about the intention of the model design to say this is a bug.

[jacob-mink-1996]

Some more research - looks like this would have a Deref trait implementation based on the mustache template. Is that correct?

[wing328]

thanks for the feedback.

cc @linxGnu

[linxGnu]

@jacob-mink-1996
Thank you for the feedback.

Yes, anyOf and allOf was not supported yet. But, now, it's here: #21948

Kindly ping @wing328 to review above PR

[jacob-vincent-mink]

Whoa! Consider this closed - I can wait on a snapshot from after your branch merges.

Had come to the conclusion today that we were doing something unsupported, but I’m glad to see that won’t be the case for much longer.

Thank you very much for the quick support!