stub refactoring, PoisonErrors wrapped, docstring

[meduketto]

Summary by CodeRabbit

Release Notes

• Bug Fixes

  • Enhanced robustness by gracefully handling internal lock failures, which now return informative runtime errors instead of causing unexpected application crashes.

• Refactor

  • Updated internal module structure and naming conventions for improved organization.

[coderabbitai]

Warning

Rate limit exceeded

@meduketto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 23 minutes and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cbed82f9-8836-48e5-8a49-9326b99d4cb4

📥 Commits

Reviewing files that changed from the base of the PR and between 9dbff59 and e679219.

📒 Files selected for processing (1)

• .github/workflows/ci.yml

📝 Walkthrough

Walkthrough

This PR renames the Python extension module from _pyiks to _iks across build configuration, package initialization, and Rust FFI. It also adds error handling for poisoned mutexes in client methods, replacing unwrap() calls with result propagation to convert lock poisoning into recoverable Python exceptions.

Changes

Module Name Update (_pyiks → _iks)

Layer / File(s)	Summary
Build Configuration Cargo.toml, pyproject.toml	Library crate name and maturin module-name config updated from _pyiks to _iks. Build artifacts exclusions added for .github/*/ and .gitignore.
Python Package Import pyiks/__init__.py	Import statement changed to use local ._iks module instead of top-level _pyiks while preserving all exported symbols in __all__.
Rust Initializer Function src/lib.rs	#[pymodule] function renamed from _pyiks to _iks to match updated library crate name.

Mutex Poisoning Error Handling

Layer / File(s)	Summary
Error Type Definition src/lib.rs	Adds PoisonError and PyRuntimeError imports; extends PyIksError enum with PoisonedMutex variant.
Error Type Conversions src/lib.rs	Implements From<PoisonError<T>> for PyIksError conversion and updates PyIksError to PyErr mapping to convert poisoned mutexes to PyRuntimeError("poisoned mutex").
Client Method Lock Acquisition src/lib.rs	Methods wait_for_stanza, send_stanza, request_roster, and send_message replace lock().unwrap() with lock()? to propagate poisoned mutex errors instead of panicking.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• meduketto/iksemel-python#10: Both PRs modify src/lib.rs to change module initialization and client mutex handling in wait_for_stanza and other methods.

Poem

🐰 A module renamed from pyiks so proud,
Now simply _iks speaks clear and loud,
And when the mutex locks grow sick and pale,
We catch the poison—no unwrap fail!
hops 🎉

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Title check	❓ Inconclusive	The title partially addresses the changes but is misleading and vague. While it mentions 'PoisonErrors wrapped' (reflecting error handling improvements), it uses cryptic terminology like 'stub refactoring' that doesn't clearly describe the primary change of renaming the Python module from '_pyiks' to '_iks'. The title also mentions 'docstring' which isn't evident in the actual changes.	Consider a more descriptive title like 'Rename Python module to _iks and handle mutex poisoning errors' to clearly reflect the main changes: module renaming and improved error handling.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch gurer/fix

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}