Added support for overriding various fields of outgoing requests

[mrashed-dev]

Description

This PR adds support for adding a new RequestOverride object which can be built with fields that can override:

• API URI
• API Key
• Timeout
• and, adding additional headers

for outgoing requests.

Usage

For all methods that call the Nylas API, there is now an additional overrides: RequestOverrides field that takes in the built object and will override the specific outgoing call with whatever non-null values are present. This can also be used to add additional headers to outgoing calls. Here's an example:

from nylas import Client

nylas = Client(
    api_key="API_KEY",
)

calendars, request_id, next_cursor = nylas.calendars.list("GRANT_ID", overrides={
 "api_key": "SECONDARY_API_KEY",
 "api_uri": "https://random.api.nylas.com",
 "timeout": 360,
 "headers": {
    "X-Header": "value"
  }
})

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.

[atejada]

All good 👍 But...you code sample is wrong 😑 Should be like this

from nylas import Client

nylas = Client(
    api_key="nyk_v0_z2TBrNMB8zcYl0BUOybx0KwZpEiXx1ZEQREpwrfVTFeZZKLdY7gDgfSacyuhhusy",
)

calendars, request_id, next_cursor = nylas.calendars.list("[email protected]", overrides= {
    "api_key": "SECONDARY_API_KEY",
	"api_uri": "https://random.api.nylas.com",
    "timeout": 360,
    "headers": {
        "X-Header": "123"
     }    
})

I'm going to add a PR to address the test errors 😎

[codecov]

Codecov Report

Attention: Patch coverage is 94.62366% with 5 lines in your changes are missing coverage. Please review.

Project coverage is 98.55%. Comparing base (b5ca361) to head (192a0d2).
Report is 5 commits behind head on main.

❗ Current head 192a0d2 differs from pull request most recent head 179a5e1. Consider uploading reports for the commit 179a5e1 to get more accurate results

Files	Patch %	Lines
nylas/handler/http_client.py	76.19%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #363      +/-   ##
==========================================
- Coverage   98.91%   98.55%   -0.36%     
==========================================
  Files          45       45              
  Lines        1654     1734      +80     
==========================================
+ Hits         1636     1709      +73     
- Misses         18       25       +7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[atejada]

All tests fixed 🥳