Migrating away from v1 Macro

[yordis]

The migration away from the use Tesla macro is an important step forward for the Tesla library. If you have any questions, please share them here.

Why are we deprecating the macro?

1. Improved Clarity: The macro approach can be confusing for newcomers as it hides implementation details behind magic. The new approach makes the client construction explicit and easier to understand.

2. Better Testing: With explicit client creation, it's easier to inject different middleware stacks or adapters during testing. You have full control over the client configuration.

3. Runtime Configuration: The macro approach makes it harder to configure clients at runtime since the middleware stack is defined at compile time. The new approach allows for dynamic client configuration based on runtime conditions.

4. Middleware Reusability: By defining middleware as a regular function returning a list, you can easily share and compose middleware configurations across different modules.