feat(python): add topic listing, update, delete and purge

[mattp5657]

Which issue does this PR address?

Closes #3521

Rationale

Completes the Python SDK's topic management by adding the missing list, update, delete, and purge operations, which previously had no Python binding and forced callers to another SDK.

What changed?

The Python SDK exposed only create_topic and get_topic, so listing, updating, deleting, or purging topics required falling back to another SDK. TopicDetails also hid compression_algorithm and replication_factor, leaving the result of an update impossible to assert from Python.

get_topics, update_topic, delete_topic, and purge_topic now bind through to the Rust TopicClient, a new Topic type backs the list view, and TopicDetails exposes the two previously hidden fields. The new methods take stream_id to stay consistent with the Rust trait and the existing get_topic.

Local Execution

• Passed
• Pre-commit hooks ran

AI Usage

Claude was used to help generate and review this PR.

[slbotbm]

Looks good at a first glance.

As an aside, please do not force push new code. Instead, address the review in well-formed commits. This helps me understand what changed since my last review.

You can write /ready on a new line in a comment to indicate that your PR is ready for review.

[slbotbm]

/author

[mattp5657]

Appreciate the comments and have addressed most of them. The remaining Topic/TopicDetails getters are tracked in #3577 as a follow-up I'll take on after this merges.

[mattp5657]

/ready

[slbotbm]

Other than a few comments, the PR looks good

[codecov]

Codecov Report

❌ Patch coverage is 99.13043% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 74.29%. Comparing base (546b212) to head (7f0a8fb).

Files with missing lines	Patch %	Lines
foreign/python/src/topic.rs	95.45%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##             master    #3572      +/-   ##
============================================
+ Coverage     74.16%   74.29%   +0.13%     
  Complexity      937      937              
============================================
  Files          1261     1249      -12     
  Lines        131930   127753    -4177     
  Branches     107800   103506    -4294     
============================================
- Hits          97849    94918    -2931     
+ Misses        30982    29802    -1180     
+ Partials       3099     3033      -66     

Components	Coverage Δ
Rust Core	74.97% <ø> (+0.15%)	⬆️
Java SDK	62.44% <ø> (ø)
C# SDK	72.06% <ø> (-0.05%)	⬇️
Python SDK	90.87% <99.13%> (+1.98%)	⬆️
PHP SDK	84.29% <ø> (ø)
Node SDK	91.35% <ø> (+0.12%)	⬆️
Go SDK	40.14% <ø> (ø)

Files with missing lines	Coverage Δ
foreign/python/src/client.rs	98.19% <100.00%> (+0.56%)	⬆️
foreign/python/src/lib.rs	100.00% <100.00%> (ø)
foreign/python/src/topic.rs	95.00% <95.45%> (+17.22%)	⬆️

... and 70 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[slbotbm]

/author

[mattp5657]

Addressed all comments. Considered adding a Rust-side test for the deterministic ordering of get_topics, but there's no existing test coverage for it to extend. Would mean a new, isolated test module rather than folding into something existing, so I left it out for now. Let me know if you have any other feedback.

[mattp5657]

/ready

[slbotbm]

lgtm