Use session auth token cookie to minimize re-auth events

[skalish]

↪️ Pull Request

This PR adds the capability to fetch and store Tamr auth cookies to reuse sessions and limit the necessary number of calls to the Tamr auth service.

For TC, auth cookie fetching is done automatically whenever a request is made to the Tamr server and a valid cookie is not already stored.

For TUC, an auth cookie is fetched when a Client is created with the store_auth_cookie parameter set to True. It is False by default. An existing Client without an auth cookie can be manually directed to fetch one with the method .set_auth_cookie().

Closes #305

💻 Examples

from tamr_unify_client.auth import UsernamePasswordAuth
from tamr_unify_client.client import Client

auth = UsernamePasswordAuth("my_username", "my_password")
client = Client(auth, store_auth_cookie=True)

# OR

client = Client(auth)
client.set_auth_cookie()

✔️ PR Todo

• [x] Testing for this change
• [x] Links to related issues/PRs
• [x] Update relevant docs + docstrings

[pcattori]

What about something like:

session: tc.Session = tc.session.make(instance=i, auth=a)

where tc.Session is a dataclass:

@dataclass(frozen=true)
class Session:
  _session: requests.Session
  auth: requests.AuthThingy
  instance: tc.Instance

[pcattori]

Or with monkey-patching:

  def __init__(self):
    self._session.request = our request function?

[github-actions[bot]]

:tada: This PR is included in version 1.4.0 :tada:

The release is available on:

• v1.4.0
• GitHub release

Your semantic-release bot :package::rocket: