[OPIK-5495] [SDK] opik.configure() parameter url mismatches config file url_override

[yaricom]

Details

Source: Claude session 2, issue #1

The Python SDK configure() method accepts url= but the ~/.opik.config file uses the field name url_override. Calling opik.configure(url_override="https://...") raises TypeError: configure() got an unexpected keyword argument 'url_override'.

Steps to reproduce:

1. Call opik.configure(url_override="https://test.dev.comet.com")
2. Get TypeError

Expected:

Parameter naming should be consistent between the API and config file, or url_override should be accepted as an alias.

Severity:

Minor

---

Summary

Deprecates the url parameter in the configure() function and introduces url_override as its replacement, logging a warning when the old parameter is used and ensuring url_override takes precedence when both are supplied.

Changes by Component

Python SDK

• Added url_override parameter to the configure() function as the canonical replacement for url.
• Added deprecation warning (LOGGER.warning) when url is passed, directing users to url_override.
• url_override takes precedence over url when both are provided; url is used as a fallback only when url_override is absent.
• Updated docstring to mark url as deprecated and document the new url_override parameter.
• Added TestConfigure test class covering all four url/url_override combinations: precedence, deprecation warning presence, warning absence, and fallback forwarding.

Files Changed

 sdks/python/src/opik/configurator/configure.py     | 13 ++++-
 sdks/python/tests/unit/configurator/test_configure.py | 59 ++++++++++++++++++++++
 2 files changed, 70 insertions(+), 2 deletions(-)

Change checklist

• User facing
• Documentation update

Issues

• Resolves #
• OPIK-5495

AI-WATERMARK

AI-WATERMARK: yes

• If yes:
  • Tools: Claude Code v2.1.81
  • Model(s): Sonnet 4.6
  • Scope: Unit tests
  • Human verification: Done

Testing

Implemented unit tests

Documentation

Added related docstrings and log output (deprecation warnings)