{"id":5988,"date":"2026-10-12T02:57:40","date_gmt":"2026-10-12T05:57:40","guid":{"rendered":"https:\/\/tucumandevelopers.com\/index.php\/2026\/10\/12\/an-overlap-contract-before-any-shift-helper-split\/"},"modified":"2026-10-12T02:57:40","modified_gmt":"2026-10-12T05:57:40","slug":"an-overlap-contract-before-any-shift-helper-split","status":"publish","type":"post","link":"https:\/\/tucumandevelopers.com\/index.php\/2026\/10\/12\/an-overlap-contract-before-any-shift-helper-split\/","title":{"rendered":"An Overlap Contract Before Any Shift Helper Split"},"content":{"rendered":"
\n
<\/div>\n

Read the comparisons before you rename any local symbol. The end minute is exclusive because abutting spans yield a zero raw window. Break credit is subtracted after the window, and it can erase a real overlap.<\/p>\n

Both of those rules stay intact in this pass. Do not replace the comparison if with a max call. Do not swap exclusive ends for inclusive ends.<\/p>\n

<\/a> Numbered workflow <\/h2>\n

<\/a> 1. Name the axes before you add rows <\/h3>\n

Write the three axes on one line in the test module. They are edge contact, midnight wrap, and break credit. A row that does not hit an axis does not earn a slot yet.<\/p>\n

<\/a> 2. Derive booleans from the listing, not from hope <\/h3>\n

Compute each expected value with the same operators as the function. If a result differs from the hoped policy, record the current result. Do not correct the table during this characterization pass.<\/p>\n

<\/a> 3. Keep one assertion per case id <\/h3>\n

Parameterize the rows so a failure prints the case id. Avoid a loop that catches errors and continues. A swallowed miss lets the helper land anyway.<\/p>\n

<\/a> 4. Run the suite and store the summary <\/h3>\n

Run the listed pytest command before any edit. Store the passed count and the six case ids. The after-run must match that stored summary.<\/p>\n

<\/a> 5. Extract only the raw window math <\/h3>\n

Move latest-start and earliest-end math into one helper. Leave break credit and the final comparison in overlaps. Do not rename fields, change 1440, or reorder arguments.<\/p>\n

<\/a> 6. Re-run, then stop the pass <\/h3>\n

Re-run the same command on the same tree. If any case id flips, revert the helper. Do not edit the expected boolean to match a new diff.<\/p>\n

<\/a> Hand check for one row <\/h2>\n

Use the one_minute_cross row as the hand check. Left span stays 540 to 601 because 601 exceeds 540. Right span stays 600 to 660 because 660 exceeds 600.<\/p>\n

Latest start is 600 because 600 exceeds 540. Earliest end is 601 because 601 is below 660. Raw window is 601 minus 600, which equals 1.<\/p>\n

Credit is 0 plus 0, so net stays 1. The boolean is true because net is greater than 0. Repeat this arithmetic for the other five rows before you commit the test file.<\/p>\n

<\/a> Outcome table derived from the listing <\/h2>\n

These six booleans follow from the operators above. Treat them as a worksheet, then recompute them locally. A mismatch means the worksheet is wrong, not that the function moved.<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n
case_id<\/th>\nleft start, end, break<\/th>\nright start, end, break<\/th>\nraw<\/th>\ncredit<\/th>\noverlaps<\/th>\n<\/tr>\n<\/thead>\n
abut_exclusive<\/td>\n540, 600, 0<\/td>\n600, 660, 0<\/td>\n0<\/td>\n0<\/td>\nfalse<\/td>\n<\/tr>\n
one_minute_cross<\/td>\n540, 601, 0<\/td>\n600, 660, 0<\/td>\n1<\/td>\n0<\/td>\ntrue<\/td>\n<\/tr>\n
wrap_vs_morning<\/td>\n1380, 60, 0<\/td>\n0, 30, 0<\/td>\n-1350<\/td>\n0<\/td>\nfalse<\/td>\n<\/tr>\n
wrap_vs_wrap<\/td>\n1320, 60, 0<\/td>\n1380, 90, 0<\/td>\n120<\/td>\n0<\/td>\ntrue<\/td>\n<\/tr>\n
break_cancels_window<\/td>\n540, 600, 30<\/td>\n570, 630, 30<\/td>\n30<\/td>\n60<\/td>\nfalse<\/td>\n<\/tr>\n
separated<\/td>\n540, 600, 0<\/td>\n660, 720, 0<\/td>\n-60<\/td>\n0<\/td>\nfalse<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

The wrap_vs_morning row is the likely premature policy edit. Under this listing the morning span stays on day zero. The wrapped span lives at 1380 to 1500, so the windows miss.<\/p>\n

Characterization keeps that miss visible in the table. The break_cancels_window row shows a second preserved result. Thirty minutes of raw overlap disappear because both breaks are summed.<\/p>\n

The sum is larger than the window, so the boolean is false. A fairer credit rule belongs in a later pass. Leave that credit rule untouched in this pass.<\/p>\n

<\/a> Test file that encodes the table <\/h2>\n

The test file below is a proposed artifact only. It has not been executed for this draft. Point it at the module only after you recompute the table. <\/p>\n

\n
import<\/span> pytest<\/span> from<\/span> shifts<\/span> import<\/span> Shift<\/span>,<\/span> overlaps<\/span> CASES<\/span> =<\/span> [<\/span> (<\/span>\"<\/span>abut_exclusive<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>540<\/span>,<\/span> 600<\/span>,<\/span> 0<\/span>),<\/span> Shift<\/span>(<\/span>600<\/span>,<\/span> 660<\/span>,<\/span> 0<\/span>),<\/span> False<\/span>),<\/span> (<\/span>\"<\/span>one_minute_cross<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>540<\/span>,<\/span> 601<\/span>,<\/span> 0<\/span>),<\/span> Shift<\/span>(<\/span>600<\/span>,<\/span> 660<\/span>,<\/span> 0<\/span>),<\/span> True<\/span>),<\/span> (<\/span>\"<\/span>wrap_vs_morning<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>1380<\/span>,<\/span> 60<\/span>,<\/span> 0<\/span>),<\/span> Shift<\/span>(<\/span>0<\/span>,<\/span> 30<\/span>,<\/span> 0<\/span>),<\/span> False<\/span>),<\/span> (<\/span>\"<\/span>wrap_vs_wrap<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>1320<\/span>,<\/span> 60<\/span>,<\/span> 0<\/span>),<\/span> Shift<\/span>(<\/span>1380<\/span>,<\/span> 90<\/span>,<\/span> 0<\/span>),<\/span> True<\/span>),<\/span> (<\/span>\"<\/span>break_cancels_window<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>540<\/span>,<\/span> 600<\/span>,<\/span> 30<\/span>),<\/span> Shift<\/span>(<\/span>570<\/span>,<\/span> 630<\/span>,<\/span> 30<\/span>),<\/span> False<\/span>),<\/span> (<\/span>\"<\/span>separated<\/span>\"<\/span>,<\/span> Shift<\/span>(<\/span>540<\/span>,<\/span> 600<\/span>,<\/span> 0<\/span>),<\/span> Shift<\/span>(<\/span>660<\/span>,<\/span> 720<\/span>,<\/span> 0<\/span>),<\/span> False<\/span>),<\/span> ]<\/span> @pytest.mark.parametrize<\/span>(<\/span> \"<\/span>case_id,left,right,expected<\/span>\"<\/span>,<\/span> CASES<\/span>,<\/span> ids<\/span>=<\/span>[<\/span>row<\/span>[<\/span>0<\/span>]<\/span> for<\/span> row<\/span> in<\/span> CASES<\/span>],<\/span> )<\/span> def<\/span> test_overlap_contract<\/span>(<\/span>case_id<\/span>,<\/span> left<\/span>,<\/span> right<\/span>,<\/span> expected<\/span>):<\/span> assert<\/span> overlaps<\/span>(<\/span>left<\/span>,<\/span> right<\/span>)<\/span> is<\/span> expected<\/span>,<\/span> case_id<\/span> <\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
  <\/a> Commands to run before and after <\/h2>\n
Use one command so the summary stays comparable. Do not mix flags between the two runs. Version wording differs across runners, so compare case ids and the passed count.<\/p>\n
Install pytest in that disposable repo before the first run. Pin that dependency locally, not from a version stated here. Confirm your interpreter accepts the listed type hints before running. <\/p>\n
\n
python -m<\/span> pytest tests\/test_shift_overlap.py -q<\/span> --tb<\/span>=<\/span>line <\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
Run that command on the unchanged listing first. Confirm six case ids and zero failed assertions. Only then apply the extraction in the helper section.<\/p>\n
  <\/a> The only edit allowed in this pass <\/h2>\n
The helper below copies the window math without changing operators. The overlaps function still applies break credit and the same check. Public names and argument order stay as they were. <\/p>\n
\n
def<\/span> raw_overlap_minutes<\/span>(<\/span>left<\/span>:<\/span> Shift<\/span>,<\/span> right<\/span>:<\/span> Shift<\/span>)<\/span> -><\/span> int<\/span>:<\/span> a0<\/span>,<\/span> a1<\/span> =<\/span> _span<\/span>(<\/span>left<\/span>)<\/span> b0<\/span>,<\/span> b1<\/span> =<\/span> _span<\/span>(<\/span>right<\/span>)<\/span> latest_start<\/span> =<\/span> a0<\/span> if<\/span> a0<\/span> ><\/span> b0<\/span> else<\/span> b0<\/span> earliest_end<\/span> =<\/span> a1<\/span> if<\/span> a1<\/span> <<\/span> b1<\/span> else<\/span> b1<\/span> return<\/span> earliest_end<\/span> -<\/span> latest_start<\/span> def<\/span> overlaps<\/span>(<\/span>left<\/span>:<\/span> Shift<\/span>,<\/span> right<\/span>:<\/span> Shift<\/span>)<\/span> -><\/span> bool<\/span>:<\/span> raw<\/span> =<\/span> raw_overlap_minutes<\/span>(<\/span>left<\/span>,<\/span> right<\/span>)<\/span> credit<\/span> =<\/span> left<\/span>.<\/span>break_min<\/span> +<\/span> right<\/span>.<\/span>break_min<\/span> net<\/span> =<\/span> raw<\/span> -<\/span> credit<\/span> return<\/span> net<\/span> ><\/span> 0<\/span> <\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
Review the diff for operator drift before you read style notes. Keep the original comparison form even when a max call looks equal. Ties match either way, but sameness is the point of this pass.<\/p>\n
  <\/a> Commit boundary <\/h2>\n
The characterization commit should contain the tests only. The extraction commit should contain the helper move only. Two commits make a flipped row obvious during review.<\/p>\n
  <\/a> Decision table for the next commit <\/h2>\n
\n\n\n\n\n\n\n\n\n\n
signal you observe<\/th>\naction in this pass<\/th>\naction deferred<\/th>\n<\/tr>\n<\/thead>\n
six ids green, diff is extraction only<\/td>\nkeep the commit<\/td>\nnone<\/td>\n<\/tr>\n
any case id flips<\/td>\nrevert the helper<\/td>\ninspect the operator that moved<\/td>\n<\/tr>\n
wrap_vs_morning should become true<\/td>\ndo not edit the pin<\/td>\nnew test name, new policy commit<\/td>\n<\/tr>\n
break credit should ignore minutes outside the window<\/td>\ndo not edit the pin<\/td>\nnew test name, new credit rule<\/td>\n<\/tr>\n
a new axis appears, such as timezone offsets<\/td>\nstop and add a row first<\/td>\nno helper split until that row is green<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
Timezone offsets are absent from the listing on purpose. Adding them inside the extraction would mix a feature with a move. That mix defeats the before-and-after summary comparison.<\/p>\n
  <\/a> Where an optional runner fits <\/h2>\n
The workflow above is complete on a local checkout. A hosted runner is optional and is not required. Disclosure: This article was prepared as part of MonkeyCode’s product outreach.<\/p>\n
MonkeyCode’s free model access can draft extra candidate rows from the three axes. Accept a row only after you recompute it from the listing. Reject any draft that changes an expected boolean without a new case id.<\/p>\n
The free server option can run the same pytest command away from your laptop. This article does not state hardware, quotas, duration, or permanence. Confirm the current terms in the product documentation before you depend on that runner.<\/p>\n
Do not upload production rosters, employee names, or secrets with the example. The teaching module uses bare minute integers only. Keep real schedules out of both the prompt and the remote workspace.<\/p>\n
  <\/a> Who should not use this approach <\/h2>\n
Skip the pin when the boolean is a known defect. A characterization suite will argue for that bug. Ship the policy fix under a new test name instead.<\/p>\n
Skip it when overlaps reads a clock, a network, or a database. Those inputs will not stay frozen across runs. Add a seam or a stub before you trust a table.<\/p>\n
Skip it when the extract cannot land in its own commit. Mixed commits hide a flipped row inside formatting noise. Split the commits, or do not call the edit a refactor.<\/p>\n
  <\/a> Limits of the six-row gate <\/h2>\n
Six rows cover the named axes, not every minute pair. They will not catch a change that preserves these windows and breaks another pair. Add a row when a review finds a new axis.<\/p>\n
The preserved break rule can erase overlap that a payroll policy would keep. This pass documents that result and does not repair it. Repair is a behavior change and needs its own table.<\/p>\n
No timing numbers or hosted-runner benchmarks appear in this article. The example was not executed for this draft. Your local recompute is the gate, not this page.<\/p>\n
If a free MonkeyCode server is already on your account, rerun pytest there. Compare case ids with the laptop summary before you trust it. Ignore any draft row you did not recompute yourself.<\/p>\n<\/p><\/div>\n<\/div>\n<\/div>\n<\/div>\n
Fuente: Art\u00edculo original<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Read the comparisons before you rename any local symbol. The end minute is exclusive because abutting spans yield a zero raw window. Break credit is subtracted after the window, and it can erase a real overlap. Both of those rules stay intact in this pass. Do not replace the comparison if with a max call. […]<\/p>\n","protected":false},"author":1,"featured_media":5987,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"webixso_pending_account_ids":""},"categories":[41],"tags":[],"class_list":["post-5988","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devto"],"jetpack_publicize_connections":[],"_links":{"self":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts\/5988","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/comments?post=5988"}],"version-history":[{"count":0,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts\/5988\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/media\/5987"}],"wp:attachment":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/media?parent=5988"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/categories?post=5988"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/tags?post=5988"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}