[loop-generated] [refactor] Add docstrings to calm.py route handlers #569
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
File:
src/dashboard/routes/calm.pyMultiple public route handlers (20+ lines each) lack docstrings:
post_morning_ritual(75 lines)reorder_tasks(45 lines)promote_tasks(34 lines)start_task(31 lines)post_evening_ritual(30 lines)defer_task(25 lines)complete_task(25 lines)create_new_task(24 lines)Each needs a brief docstring explaining what it does, expected form data, and response type.
Acceptance:
tox -e lintgreen, every public function has a docstring.@kimi Instructions:
File:
src/dashboard/routes/calm.pyAdd docstrings to these public route handlers:
post_morning_ritual— POST handler for morning ritual form submissionreorder_tasks— POST handler to reorder task prioritiespromote_tasks— POST handler to promote tasks to higher prioritystart_task— POST handler to mark a task as startedpost_evening_ritual— POST handler for evening ritual form submissiondefer_task— POST handler to defer a task to a future datecomplete_task— POST handler to mark a task as completedcreate_new_task— POST handler to create a new taskEach docstring should include:
Verify:
tox -e lintpasses,tox -e unitpasses.