feat(stdlib): add datetime module bindings

[github-actions]

🤖 This is an automated pull request from Repo Assist, an AI assistant for this repository.

Summary

Adds F# bindings for Python's datetime module — one of the most-used modules in the stdlib and previously absent from Fable.Python.

Changes

New file: src/stdlib/Datetime.fs

Covers the five main classes:

Class	Key features bound
timedelta	days, seconds, microseconds, total_seconds() + keyword-argument factory
date	year/month/day, isoformat(), strftime(), fromisoformat(), today(), fromtimestamp(), weekday(), replace()
time	hour/minute/second/microsecond, isoformat(), strftime(), fromisoformat()
datetime	Full date+time properties, now(), utcnow(), fromisoformat(), strptime(), combine(), timestamp(), isoformat(), astimezone(), replaceDate(), replaceTime()
timezone	Fixed-offset factory, utc singleton

New file: test/TestDatetime.fs — 30 tests covering all bound classes.

Design Decisions

• Each class has a separate static factory type (e.g. datetimeStatic) alongside the instance type (datetime). This mirrors the pattern in Functools.fs and Itertools.fs and keeps class methods separate from instance methods.
• Constructor Emit templates wrap integer args with int(...) to handle Fable's Int32 boxing correctly.
• timedelta.Create and time.Create use [<NamedParams>] + [<Emit("$0($1...)")>] so callers can write timedelta.Create(days = 2.0, hours = 3.0) idiomatically.
• datetime.isoformat has two overloads: no-arg (default T separator) and a sep: string overload via [<Emit>].
• replaceDate and replaceTime use named-keyword Emits to avoid the complex optional-parameter combinatorial explosion of Python's datetime.replace(...).
• No breaking changes — this is a purely additive module.

Trade-offs

• tzinfo (abstract base class) is not bound since it is rarely used directly by consumers; timezone covers the common use-case.
• datetime.replace() is split into replaceDate and replaceTime helpers rather than a single method with many optional args; this avoids a complex overload matrix while covering the most common use-cases.
• astimezone accepts obj for the tz parameter to avoid a circular dependency with timezone.

CI will validate the build and all 30 new tests.

Note

🔒 Integrity filter blocked 10 items

The following items were blocked because they don't meet the GitHub integrity level.

• How does it generate the python source from AST? #5 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Roadmap #15 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Create Pyi parser #22 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• string format specifier '{i:X4}' not working #36 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Support for Attributes? #48 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• Pandas binding #65 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• typeshed: generate bindings automatically ~ python glutinum? #115 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• auto pip installation of dependencies during compilation of scripts #117 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• allow TextIOWrapper to be enumerated #131 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• support for asynchronous context managers #134 list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Repo Assist · ● 2.3M · ◷