Development Insight - Resty v3.0.0

[jeevatkm]

This discussion aims to provide high-level insight into v3.0.0 development. Feel free to engage and share ideas and inputs.

Branching Approach

• Branch v2 will be created and set as the default branch on GitHub.
• Rename branch master to branch main.
• The file go.mod on the main branch will be updated to github.com/go-resty/resty/v3 and go version.
• The v3 feature development will branch out from the main branch. When ready, PR will be created against the main branch.
• When v3 is ready, the main branch will become the default branch on GitHub.

Design Improvements (Possibly will result in breaking changes)

Client

• Currently, there are three ways to create clients. I will add additional ways to create a Resty client.
  • One of them will be fully composable middleware during client creation.
  • Make it easy, WASM dial content
• Add an option to provide all the timeout values during client creation.
• Read-Write Mutex will be added into the client struct to make all the client properties thread-safe
  • All the exported fields will become getter methods, e.g., client.BaseURL => client.BaseURL()
• Improving TLS config handling
• Improving Transport handling

Middleware

• Introducing Package middleware with all the existing middleware will be exported, and the sub-function will be exposed as complete middleware.
  • The middleware approach will be the first-class citizens to tackle many practical scenarios, such as authentication, authorization, tracing, content-type handling, debug logger, and much more in the request and response processing pipeline.
• Pluggable Service discovery interface

Retry, Redirect

• Debating about creating the package; it is still being decided!! Is it worth it??

And so on.

• First v3-selected labeled issues will be focused from v3.0.0 Milestone
  • Then, the v3-consideration labeled issues will be focused on.
• Deprecated line items will be removed
• Introducing package internal to park certain internal functionality

Documentation and Website

• Resty needs to get out of Readme and provide as much how-to documentation as possible. Resty user's contribution is welcome.
• Go lang supports the latest two versions. I'm debating whether two or four of the latest versions result in a minimum version on Resty's go.mod file.
• I have purchased the two TLDs, resty.dev and go-resty.org, and I'm wondering which one to use it.
• We need to think about a simple and effective logo for Resty. I'm looking for Resty user's inputs.

---

So far, I have captured my thoughts and will continue to do so here.

[SVilgelm]

Also need to decide if the requests objects are immutable as well as the client objects by the internal code. If it is, then we can reuse the request objects, otherwise make a clear statement in the documentation.

I think the client object should be thread-safe via RW mutex, but the request should not.

[jeevatkm]

I'm considering keeping the Request object's nature as-is, and I agree on the client object with RW mutex.