Add NonExistentTimeError Handling for Daylight Saving Time (DST) Transitions

[pedroigorjs]

Context

This PR fixes an issue where datetime nodes would fail when handling dates that fall into nonexistent or ambiguous time periods during daylight saving time (DST) transitions. When clocks spring forward or fall back, certain times either don't exist or are ambiguous, causing errors in pandas timezone operations.

Problem

When localizing or converting datetime values in timezones with DST, the tz_localize() method would raise errors for:

• Nonexistent times: Times that don't exist during spring forward transitions (e.g., 2:30 AM when clocks jump from 2:00 AM to 3:00 AM)
• Ambiguous times: Times that occur twice during fall back transitions (e.g., 2:30 AM when clocks fall back from 3:00 AM to 2:00 AM)

Solution

Added proper handling for nonexistent and ambiguous times by configuring the tz_localize() method with appropriate parameters across all affected nodes:

• nonexistent="shift_forward": Automatically shifts nonexistent times to the next valid time
• ambiguous="NaT": Returns NaT (Not a Time) for ambiguous times, or handles them appropriately per node context

Changes Made

Modified Nodes

1. ToISOFormat

Updated the convert_to_iso internal function to handle DST edge cases when converting string dates to ISO format.

2. DifferenceBetweenDates

Updated the replace_invalid internal function to handle DST edge cases when localizing naive timestamps for date difference calculations.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	3	89%	106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	75	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	3.997s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	5	82%	17–18, 106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	77	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	5.333s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	3	89%	106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	75	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	3.887s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	5	82%	17–18, 106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	77	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	5.274s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	5	82%	17–18, 106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	77	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	5.431s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	3	89%	106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	75	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	4.119s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	5	82%	17–18, 106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	77	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	4.877s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	50	4	92%	35, 97, 104, 107
executor.py	122	10	92%	62, 74–75, 144, 208, 252, 267, 271, 283, 291
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
check.py	41	3	93%	23, 26, 89
constants.py	92	3	97%	122, 125, 170
math.py	43	1	98%	75
retrack/nodes/dynamic
base.py	16	1	94%	26
csv_table.py	43	2	95%	59, 62
flow.py	44	1	98%	18
retrack/utils
component_registry.py	105	18	83%	77–78, 81–82, 85–86, 91–92, 101, 112–123
exceptions.py	28	3	89%	106–127
graph.py	60	7	88%	35, 46, 59, 61, 63, 84, 86
registry.py	34	6	82%	23–26, 38, 43, 51
retrack/validators
base.py	4	1	75%	14
node_exists.py	15	2	87%	36, 38
node_validator.py	33	3	91%	31, 56–57
TOTAL	1402	75	95%

Tests	Skipped	Failures	Errors	Time
90	0 💤	0 ❌	0 🔥	3.920s ⏱️