Litellm oss staging 02 22 2026

[krrishdholakia]

Relevant issues

Pre-Submission checklist

Please complete all items before asking a LiteLLM maintainer to review your PR

• I have Added testing in the tests/litellm/ directory, Adding at least 1 test is a hard requirement - see details
• My PR passes all unit tests on make test-unit
• My PR's scope is as isolated as possible, it only solves 1 specific problem
• I have requested a Greptile review by commenting @greptileai and received a Confidence Score of at least 4/5 before requesting a maintainer review

CI (LiteLLM team)

CI status guideline:

• 50-55 passing tests: main is stable with minor issues.
• 45-49 passing tests: acceptable but needs attention
• <= 40 passing tests: unstable; be careful with your merges and assess the risk.

• Branch creation CI run
  Link:

• CI run for the last commit
  Link:

• Merge / cherry-pick CI run
  Links:

Type

🆕 New Feature
🐛 Bug Fix
🧹 Refactoring
📖 Documentation
🚄 Infrastructure
✅ Test

Changes

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
litellm	Error		Feb 22, 2026 4:14am

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[CLAassistant]

All committers have signed the CLA.

[greptile-apps]

Greptile Summary

This staging PR bundles three independent changes:

1. Timezone handling overhaul: Replaces the hardcoded timezone offset map in duration_parser.py with Python's zoneinfo.ZoneInfo, enabling support for all IANA timezones and automatic DST handling. The timezone_utils.py module is simplified to read the timezone from litellm.timezone (set via setattr by proxy_server.py at startup) instead of importing general_settings from proxy_server — eliminating a circular import risk.

2. Streaming handler type annotations: Adds return type annotations (Iterator/AsyncIterator/ModelResponseStream) to the iterator protocol methods on CustomStreamWrapper. No behavioral changes.

3. Gollem Go agent framework cookbook: Adds a new cookbook example demonstrating how to use the gollem Go agent framework with LiteLLM as a proxy gateway, including basic, streaming, and tool-use examples.

Additional minor changes: ruff lint suppressions for three proxy files, sidebar navigation update, and documentation for IANA timezone support.

Confidence Score: 4/5

• This PR is safe to merge — the timezone refactor is a clear improvement with good test coverage, and the other changes are low-risk.
• Score of 4 reflects: well-tested timezone changes with DST coverage, correct use of ZoneInfo replacing a buggy hardcoded map, proper cleanup of circular import pattern, and type-only changes to streaming handler. Deducted 1 point because this is a staging PR bundling multiple unrelated changes (timezone fix, type annotations, cookbook), and the PR description checklist items are unchecked.
• No files require special attention — the core logic changes in duration_parser.py and timezone_utils.py are well-covered by new tests.

Important Files Changed

Filename	Overview
litellm/litellm_core_utils/duration_parser.py	Replaces hardcoded timezone offset map with ZoneInfo for proper IANA timezone and DST support. Variable rename from timezone to tz avoids shadowing the stdlib timezone class.
litellm/litellm_core_utils/streaming_handler.py	Adds return type annotations to iterator protocol methods (__iter__, __aiter__, __next__, __anext__). No behavioral changes.
litellm/proxy/common_utils/timezone_utils.py	Replaces general_settings dict lookup with getattr(litellm, "timezone", None), eliminating circular import risk and aligning with how proxy_server.py sets litellm_settings as module attributes.
tests/test_litellm/litellm_core_utils/test_duration_parser.py	Adds tests for previously-unsupported IANA timezones (Tokyo, Sydney, Chicago) and DST transitions (fall-back and spring-forward). All tests are pure mock-free unit tests.
tests/test_litellm/proxy/common_utils/test_timezone_utils.py	Removes fastapi.testclient import, adds tests for get_budget_reset_timezone (reading litellm attr, fallback to UTC, None handling, timezone-aware reset). Tests properly clean up litellm module state.
ruff.toml	Adds PLR0915 (too-many-statements) ignore rules for three proxy files and fixes missing newline at EOF.
docs/my-website/docs/proxy/budget_reset_and_tz.md	Adds documentation note about IANA timezone support via Python's zoneinfo module and automatic DST handling.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["proxy_server.py startup"] -->|"setattr(litellm, 'timezone', value)"| B["litellm.timezone module attribute"]
    C["get_budget_reset_timezone()"] -->|"getattr(litellm, 'timezone', None)"| B
    C -->|"fallback"| D["'UTC'"]
    C --> E["get_budget_reset_time(budget_duration)"]
    E --> F["get_next_standardized_reset_time()"]
    F --> G["_setup_timezone(current_time, timezone_str)"]
    G -->|"new: ZoneInfo(timezone_str)"| H["Proper IANA tz with DST"]
    G -->|"old: hardcoded map lookup"| I["Fixed UTC offset - no DST"]
    H --> J["_handle_day_reset / _handle_hour_reset / ..."]
    J --> K["Next reset datetime in correct timezone"]

Loading

_{Last reviewed commit: 52585eb}

[greptile-apps]

_{15 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}