Skip to content

Tags: 567-labs/instructor

Tags

v1.11.3

Toggle v1.11.3's commit message
Merge branch 'feat/failed-attempts-propagation'

1.11.2

Toggle 1.11.2's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
fix(exceptions): restore backwards compatibility for instructor.excep…

…tions imports (#1789)

## Summary
- Restore backwards compatibility for `instructor.exceptions` imports
that broke in v1.11.0
- Add deprecation warnings to guide users to new import path
`instructor.core`
- Bump version to 1.11.2 (patch version for backwards compatibility fix)

## Problem
Version 1.11.0 introduced a breaking change by removing the backwards
compatibility module `instructor/exceptions.py`. This caused imports
like `from instructor.exceptions import InstructorRetryException` to
fail, breaking downstream applications without warning.

## Solution
- Recreated `instructor/exceptions.py` with proper re-exports from
`instructor.core.exceptions`
- Added deprecation warnings to guide users to the recommended import
path
- Used proper semantic versioning (patch bump) for a backwards
compatibility fix

## Test plan
- [x] Test that old import path works: `from instructor.exceptions
import InstructorRetryException`
- [x] Test that new import path still works: `from instructor.core
import InstructorRetryException`
- [x] Verify deprecation warning is shown when using old import path
- [x] Run linting and type checking
- [x] Version bump to 1.11.2

🤖 Generated with [Claude Code](https://claude.ai/code)
<!-- ELLIPSIS_HIDDEN -->

----

> [!IMPORTANT]
> Restores backwards compatibility for `instructor.exceptions` imports
with deprecation warnings and bumps version to 1.11.2.
> 
>   - **Behavior**:
> - Reintroduces `instructor/exceptions.py` to restore backwards
compatibility for imports like `from instructor.exceptions import
InstructorRetryException`.
> - Adds deprecation warning in `instructor/exceptions.py` to guide
users to `instructor.core`.
>   - **Versioning**:
> - Bumps version to 1.11.2 in `pyproject.toml` and `uv.lock` for
backwards compatibility fix.
> 
> <sup>This description was created by </sup>[<img alt="Ellipsis"
src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=567-labs%2Finstructor&utm_source=github&utm_medium=referral)<sup>
for ff9d88f. You can
[customize](https://app.ellipsis.dev/567-labs/settings/summaries) this
summary. It will automatically update as commits are pushed.</sup>

<!-- ELLIPSIS_HIDDEN -->

v1.11.1

Toggle v1.11.1's commit message
chore: bump version to 1.11.1

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

v1.11.0

Toggle v1.11.0's commit message
chore: bump version to 1.11.0

This version includes architectural refactoring, provider reorganization, and enhanced documentation.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

1.10.0

Toggle 1.10.0's commit message
fix(tests): update model name and mode in test_multimodal.py

1.9.2

Toggle 1.9.2's commit message
Fix xAI provider model name parsing in from_provider()

Remove incorrect model name split that was causing ValueError when using
xAI provider through from_provider() function. The model_name is already
extracted from the initial provider/model split.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

1.9.1

Toggle 1.9.1's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
Json schema fix (#1657)

Co-authored-by: Jason Liu <[email protected]>

1.9.0

Toggle 1.9.0's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
Feat/add gemini optional support (#1618)

Co-authored-by: Jason Liu <[email protected]>

1.8.3

Toggle 1.8.3's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
fix: bump version (#1545)

1.8.2

Toggle 1.8.2's commit message

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
fix: removed print statement (#1524)