CodeSampleX

Sample

python-dateutil 2.9.0.post0: Parse an ambiguous date string in Python without silently getting the wrong day

Verified sample for pypi python-dateutil 2.9.0.post0: Parse an ambiguous date string in Python without silently getting the wrong day. The contract ran on…

sha256:ac8996a0194a777a7c8444b72c24f2f09fe9729cf3b7be94dcbb8422d0f59be2

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
3
Signing keys that built it
3
Declared environment python 3.12 linux x64 python 3.12 python pip

Verification-run environments

Environment Contract Stages Run
python 3.12 · linux alpine/x64 · docker ed25519:a2ec939a4c60e243 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · python@1		 2026-08-13
python 3.12 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · python@1		 2026-08-17
python 3.12 · linux debian/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · python@1python:3.12-slim@sha256:09f7da3bc104…		 2026-09-08

Case

FIX
Goal
Parse an ambiguous date string in Python without silently getting the wrong day
Packages
Symbols
  • dateutil.parser.parse
  • relativedelta
Environment
python 3.12
Created
2026-08-13T15:47:04Z

Contract

  1. parse an ISO timestamp and an ambiguous numeric date
  2. assert dayfirst decides between 03/04 readings
  3. assert an unparseable string raises rather than guessing
  4. assert relativedelta adds calendar months, not 30 days

Files

  • csx.json
  • requirements.txt
  • src/__init__.py
  • src/dates.py
  • test/contract.py

Download the source artifact (tar.gz)

Source

csx.json
{"case":{"caseId":"case:sha256:7a794c6818facb6f50920f4df838a9f76f5e53b2294fb1cc9dec5a52208b6a93","constraints":{"runtime":"python"},"contract":["parse an ISO timestamp and an ambiguous numeric date","assert dayfirst decides between 03/04 readings","assert an unparseable string raises rather than guessing","assert relativedelta adds calendar months, not 30 days"],"goal":"Parse an ambiguous date string in Python without silently getting the wrong day","kind":"FIX","packages":["pkg:pypi/python-dateutil@2.9.0.post0"],"schemaVersion":1,"symbols":["dateutil.parser.parse","relativedelta"]},"contractCommand":["python","test/contract.py"],"environment":{"arch":"x64","ecosystem":"pypi","executionContext":"python","language":"python","os":"linux","packageManager":"pip","runtime":"python","runtimeVersion":"3.12","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/python-dateutil@2.9.0.post0"],"schemaVersion":1,"symbols":["dateutil.parser.parse","relativedelta"],"verifierAdapter":"python@1"}
requirements.txt
python-dateutil==2.9.0.post0
six==1.17.0
src/__init__.py
src/dates.py
"""Date parsing with dateutil, including the ambiguity nobody expects."""

from dateutil import parser
from dateutil.relativedelta import relativedelta


def parse(text, dayfirst=False):
    """Parse a date string.

    "03/04/2026" is March 4th in the US reading and April 3rd elsewhere, and
    dateutil picks the US one unless told otherwise. It is not a bug and it
    will not warn — pass dayfirst explicitly whenever the input is not ISO.
    """
    return parser.parse(text, dayfirst=dayfirst)


def add_months(dt, months):
    """Add calendar months. timedelta(days=30*n) drifts; relativedelta does not."""
    return dt + relativedelta(months=months)
test/contract.py
import os
import sys

sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
from src.dates import add_months, parse

iso = parse("2026-08-13T09:05:00")
assert (iso.year, iso.month, iso.day, iso.hour) == (2026, 8, 13, 9)

# The ambiguity: same input, two readings, decided by dayfirst.
us = parse("03/04/2026")
eu = parse("03/04/2026", dayfirst=True)
assert (us.month, us.day) == (3, 4)
assert (eu.month, eu.day) == (4, 3)

try:
    parse("definitely not a date")
except Exception:
    pass
else:
    raise AssertionError("unparseable input must raise, not guess")

# Calendar months: Jan 31 + 1 month is Feb 28, not March 2.
end_of_jan = parse("2026-01-31")
assert add_months(end_of_jan, 1).strftime("%Y-%m-%d") == "2026-02-28"
assert add_months(parse("2026-08-30"), 6).strftime("%Y-%m-%d") == "2027-02-28"

print("CONTRACT PASS: dateutil resolved the ambiguous date and month arithmetic")

Origin Seeder

anonymous