Skip to content

Docstrings cleanup#24

Merged
claudious96 merged 3 commits into
mainfrom
fix/docstrings-cleanup
Apr 29, 2026
Merged

Docstrings cleanup#24
claudious96 merged 3 commits into
mainfrom
fix/docstrings-cleanup

Conversation

@claudious96

@claudious96 claudious96 commented Apr 29, 2026

Copy link
Copy Markdown
Owner

Remove leftovers from the transition from 0.1.0 to 0.2.0 and fix broken or missing docstrings.

In 0.2.0 we removed the executor pattern, but the executor attribute was
never cleaned up.
- delete_items: tuple shape was documented as (scheduled_ts, key, item)
  but the actual tuple is (scheduled_ts, item)
- cancel_event: Returns section claimed (int) but actual return type is
  list[tuple[float, CalendarEvent]]
- clear: description said 'The number of cancelled events' instead of
  'List of cancelled events'
@codecov

codecov Bot commented Apr 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Files with missing lines Coverage Δ
src/calendar_queue/calendar.py 93.75% <100.00%> (-0.13%) ⬇️
src/calendar_queue/calendar_queue.py 84.95% <100.00%> (+0.27%) ⬆️
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

get_nowait() is inherited from asyncio.Queue and pops the next heap entry
immediately without checking whether its timestamp has been reached.

Add an explicit override with a docstring that makes this behavior
visible via the docstring in IDEs' intellisense.
@claudious96 claudious96 force-pushed the fix/docstrings-cleanup branch from 2184420 to bb11e59 Compare April 29, 2026 12:33
@claudious96 claudious96 merged commit e6e3698 into main Apr 29, 2026
27 of 29 checks passed
@claudious96 claudious96 deleted the fix/docstrings-cleanup branch April 29, 2026 12:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant