Metadata-Version: 2.4
Name: wtwco-igloo
Version: 2.2.0
Summary: Python SDK for Igloo Cloud
License: MIT
License-File: LICENSE.txt
Author: WTW
Author-email: software.support@wtwco.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
Requires-Dist: aiohttp (>=3.13.5,<4.0.0)
Requires-Dist: authlib (>=1.6.11,<2.0.0)
Requires-Dist: azure-core (>=1.38.2,<2.0.0)
Requires-Dist: azure-storage-blob (>=12.28.0,<13.0.0)
Requires-Dist: cryptography (>=46.0.7,<47.0.0)
Requires-Dist: keyring (>=25.7.0,<26.0.0)
Requires-Dist: msal[broker] (>=1.35.1,<2.0.0)
Requires-Dist: pydantic (>=2.12.5,<3.0.0)
Requires-Dist: pyjwt (>=2.12.1,<3.0.0)
Requires-Dist: requests (>=2.33,<3.0)
Requires-Dist: urllib3 (>=2.6.3,<3.0.0)
Requires-Dist: wtwco-igloo-cloud-api-client (==5.0.0)
Description-Content-Type: text/markdown

# Igloo Python Connector

Igloo Python Connector is a Python wrapper for the Igloo Cloud API. It also provides additional useful methods and examples.

## Installation

To install the latest version of Python, please visit the [official website](https://www.python.org/downloads/). 
Note, this package supports Python 3.10 and above.

We recommend installing this package inside a Python virtual environment. 
For more information, see the [virtual environment documentation](https://docs.python.org/3/library/venv.html#creating-virtual-environments).

Once created, please activate your virtual environment and install the Igloo Python Connector package using the following command:

```shell
pip install wtwco-igloo
```

You should now be able to import the package in your Python code:

```python
import wtwco_igloo
```

## Connecting to the API

Connect to the API using interactive token:

```python
from wtwco_igloo import Connection

connection = Connection.from_interactive_token(api_url, client_id, tenant_id)

# View your workspaces
print(connection.get_workspaces())
```

## Documentation and Examples

For documentation and examples please see [WTW Client Services](https://clientservices.insurancetechnology.com/).

## Release Notes

### 2.2

#### 2.2 - Improvements

1. New Auth0 authentication methods added to the `Connection` class for Igloo Cloud systems that are configured to use Auth0 as the identity provider:
    - `from_auth0_interactive` for interactive browser-based authentication with secure credential storage.
    - `from_auth0_secret` for Machine-to-Machine authentication using OAuth 2.0 client credentials.
    - `from_auth0_private_key_jwt` for Machine-to-Machine authentication using private key JWT bearer assertions.
1. Support for refresh token rotation, always preferring the system keyring for secure token storage.
1. Improved performance of run result CSV comparisons.
1. New example `auth0_interactive_example.py` demonstrating Auth0 interactive authentication.

#### 2.2 - Security

1. Updated third-party package dependencies to pick up upstream security and stability fixes.

For documentation and examples please see [WTW Client Services](https://clientservices.insurancetechnology.com/).

