Python SDK

Python SDK Changelog

Below is the changelog of our Python SDK, oso-cloud:

2.4.1

  • Added missing dependency on typing_extensions

2.4.0

  • Use Fallback, if configured, for .evaluate_local_select and .evaluate_local_filter if Oso Cloud returns an error (Requires Fallback 1.0.0 or later)

2.3.0

  • Use Fallback, if configured, for .get_policy_metadata if Oso Cloud returns an error (Requires Fallback 1.0.0 or later)

2.2.0

  • Add .evaluate_local_select and .evaluate_local_filter functions to the Query Builder to support querying with Local Authorization.

2.1.0

  • Use Fallback, if configured, for .get, Query Builder, and local check APIs if Oso Cloud returns an error (Requires Fallback 0.3.1 or later)
  • Use Fallback, if configured, if Oso Cloud returns an HTTP error (400, 5xx)

2.0.1

Add support for context fact in Local Authorization methods

2.0.0

This release contains several breaking changes. There's a migration guide for upgrading from version 1.x, and don't hesitate to reach out if you run into any issues.

Simplified Fact Management API

Reduced the number of methods for managing facts in Oso Cloud from five to three:

  • tell is now insert.
  • delete has been upgraded to support wildcard deletions.
  • bulk, bulkTell, and bulkDelete have been replaced with a new transactional batch API.

See the Centralized Authorization Data API doc and the migration guide for more details.

Powerful new QueryBuilder API for querying arbitrary rules in your policy

See the API docs and the migration guide for more details.

1.5.1

  • Add X-Request-ID header to uniquely identify individual API requests; include this ID in error messages for better debugging.

1.5.0

  • Added new oso.actions_local() method.
  • Accept bool and int as fact args. These are converted to the appropriate Polar type.

1.4.1

Update error message wording.

1.4.0

Added support for the local check api:

1.3.x

Along with support for fetching policy metadata, oso-cloud 1.3.0 introduced more specific parameter and return types for the Python client to be used with typecheckers like mypy.

Releases 1.3.1 - 1.3.3 addressed bugs or gaps found with the new types that were added.