Skip to content

Conversation

jacob-mink-1996
Copy link

This change enables two related features in the rust-axum server generator

  1. text/event-stream responses
  2. multi-part responses (e.g. 200: application/json & text/event-stream)

The core of the feature is to iterate over the content types rather than taking just the first, then build up a new list in the vendor extensions that includes the appropriate information. I took the approach of still keeping the templates simple and tried to compute types in the Java code as much as possible - we could of course go the other way and expand the type within the template, but it got pretty gnarly.

@linxGnu - I adopted a bit of a hybrid approach to the typing we discussed since this isn't just a return type change, it changes the enums. I went ahead and used a

Pin<Box<dyn Stream<Item = Result<..., Box<dyn Error>>>>>

(along with appropriate Sends/Syncs/'static annotations). This allowed me to shove it in an enum, and it appears to play nice with other methods that return an impl Stream or impl TryStream, both of which can be coerced into the pin-box using the .boxed() method from StreamExt.

Finally, the templates are updated to support the new code gen. I have validated this two ways:

  1. I wrote some unit tests that verify that the right types and names are present
  2. I ran this generator on the real project I'm working on that uses this and have been able to refactor my code based on this new support nicely.

PR checklist

  • Read the contribution guidelines.
  • Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
  • Run the following to build the project and update samples:
    ./mvnw clean package || exit
    ./bin/generate-samples.sh ./bin/configs/*.yaml || exit
    ./bin/utils/export_docs_generators.sh || exit
    
    (For Windows users, please run the script in WSL)
    Commit all changed files.
    This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master.
    These must match the expectations made by your contribution.
    You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example ./bin/generate-samples.sh bin/configs/java*.
    IMPORTANT: Do NOT purge/delete any folders/files (e.g. tests) when regenerating the samples as manually written tests may be removed.
  • File the PR against the correct branch: master (upcoming 7.x.0 minor release - breaking changes with fallbacks), 8.0.x (breaking changes without fallbacks)
  • If your PR solves a reported issue, reference it using GitHub's linking syntax (e.g., having "fixes #123" present in the PR description)
    fixes [REQ] [rust-axum] support text/event-stream #21967
  • If your PR is targeting a particular programming language, @mention the technical committee members, so they are more likely to review the pull request.

@frol (2017/07) @farcaller (2017/08) @richardwhiuk (2019/07) @paladinzh (2020/05) @jacob-pro (2022/10) @dsteeley (2025/07)

… stream and resposne enums

Keep going, there are tests failing

Remove the "single item" legacy support and wrap it in the multipart content umbrella

Functional testing (with a test that can be uncommented to actually test building code if cargo is available)

Fixing the box/pin for the stream to behave well in real code

Cleanup unused extensions

Clean up the operations

Ensure the stream info propagates to other parts of the generator

Cleanup tests
@jacob-mink-1996 jacob-mink-1996 force-pushed the jmink/support-multiple-response-types branch from bcc335f to e95ced8 Compare October 9, 2025 16:34
@linxGnu
Copy link
Contributor

linxGnu commented Oct 10, 2025

@jacob-mink-1996 just fyi, I will have a look this weekend

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[REQ] [rust-axum] support text/event-stream

2 participants