Tests: Run Couchbase container on Docker-assigned ports

[hampsterx]

What

The Couchbase test container binds host ports 1:1 (8091, 11210...), so test_couchbase_source_local clashes with any Couchbase Server already running on the workstation and can fail outright. The pending testcontainers-python Couchbase support binds the same ports 1:1, so adopting it as-is would not remove the conflict.

This switches the container to Docker-assigned host ports and advertises them to SDK clients via Couchbase alternate addresses, so the integration test runs alongside a local Couchbase instead of requiring you to stop it first.

Changes

• CouchbaseContainer now uses with_exposed_ports(8091, 8092, 8093, 11210) instead of fixed 1:1 binds.
• After bucket creation it configures Couchbase alternate addresses with couchbase-cli setting-alternate-address for the mapped mgmt/kv/n1ql/capi ports.
• Connection strings use the mapped KV port with network=external, so the SDK bootstraps through the alternate addresses rather than the container-internal ones.
• CouchbaseSource.dlt_source() preserves non-ssl URI query parameters (so network=external reaches the SDK) while still consuming ssl=true internally to upgrade couchbase:// to couchbases://.
• Adds Docker-free unit tests for the URI query-parameter handling.
• Updates the integration-test docstring, which no longer requires stopping a local Couchbase Server.

Test plan

• ruff format --check and ruff check clean on touched files
• ty check omniload clean
• Docker-free unit tests: pytest tests/main/test_sources.py::CouchbaseSourceTest (2 passed
• Integration test green against a real local Couchbase running on 8091: pytest tests/warehouse/db/test_couchbase.py::test_couchbase_source_local[duckdb]) 1 passed

Closes #82

[amotl]

Wonderful, thank you for cleaning this up. Did you use the testcontainers implementation from this patch by @amithkoujalgi, or did you just strip away the static port assignments of the existing implementation?

• testcontainers/testcontainers-python#790

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 50.28%. Comparing base (f74d292) to head (e7c4db5).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #127      +/-   ##
==========================================
+ Coverage   50.22%   50.28%   +0.06%     
==========================================
  Files         188      188              
  Lines        8948     8951       +3     
==========================================
+ Hits         4494     4501       +7     
+ Misses       4454     4450       -4     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.