[samdark]

Fixes #347.

Keep existing application signal handlers intact when a SignalLoop is created. Queue consumers and commands take over signal handling while processing messages, finish the current message before stopping, and restore application handlers when processing ends or fails. Commands that process several queues keep graceful shutdown active between queues.

Add ScopedLoopInterface for custom loops that need setup and cleanup around consumption. Preserve standalone canContinue() behavior, where the loop keeps its signal handlers for the rest of the process. Document how to stop and pause workers, share a loop when configuring commands manually, and restore handlers in custom execution loops.

Summary by Sourcery

Scope SignalLoop signal handling to message consumption while preserving application handlers and graceful shutdown behavior.

New Features:

• Add scoped loop lifecycle support for setting up and cleaning up process-wide state around message consumption.
• Allow commands to share a loop instance so graceful shutdown remains active across multiple queues.

Bug Fixes:

• Preserve existing application signal handlers when creating a SignalLoop and restore them after consumption or processing failures.
• Ensure workers finish the current message and stop before processing subsequent messages after a shutdown signal.

Enhancements:

• Support nested loop scopes and retain standalone canContinue() behavior for long-lived signal handling.

Documentation:

• Document graceful worker stopping and pausing, manual command loop sharing, custom execution-loop cleanup, and ScopedLoopInterface usage.

Tests:

• Add coverage for signal-handler preservation, restoration, nested scopes, graceful shutdown, queue boundaries, and failure handling.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.15%. Comparing base (ab17e34) to head (8af7835).

Additional details and impacted files

@@             Coverage Diff              @@
##             master     #348      +/-   ##
============================================
+ Coverage     94.90%   95.15%   +0.24%     
- Complexity      375      395      +20     
============================================
  Files            59       59              
  Lines           981     1031      +50     
============================================
+ Hits            931      981      +50     
  Misses           50       50              

☔ 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.

[sourcery-ai]

Sourcery assessment

Approved.