Improve Execution Serialization

[pedroigorjs]

This pull request introduces enhancements to execution tracking and output normalization in the retrack engine. The main changes add support for node aliases, improve serialization of execution data, and introduce a utility for DataFrame normalization. These updates make execution outputs more readable and structured, and provide better context through node aliases.

Execution Tracking and Serialization Improvements:

• Added an aliases attribute to the Execution class, along with methods to set and store node aliases during execution. This allows each node's output to be associated with a human-readable alias.
• Implemented the to_normalized_dict method in Execution, which serializes inputs, outputs, child executions, and results into a normalized dictionary format for easier downstream processing and inspection.

Node Alias Support:

• Added an alias() method to the BaseNode class, which returns a node's alias if available, falling back to its name. This ensures consistent alias retrieval for execution tracking.

Utility Functions:

• Added the to_normalized_dict function in retrack/utils/transformers.py to convert DataFrame columns into a list of dictionaries with names and values, supporting the new serialization logic.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	87	27	69%	43, 115–194, 203, 210, 213
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	51	2	96%	104, 111
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
transformers.py	23	15	35%	15, 49–79
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	1474	115	92%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	3.827s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	87	27	69%	43, 115–194, 203, 210, 213
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	51	2	96%	104, 111
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
transformers.py	23	15	35%	15, 49–79
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	1474	117	92%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	5.318s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	126	113	10%	16, 24–39, 63–111, 128–186, 200–302, 333–363
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	1563	199	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	5.038s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	126	113	10%	16, 24–39, 63–111, 128–186, 200–302, 333–363
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	1563	197	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	3.932s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	109	98	10%	16–31, 55–103, 120–178, 192–294
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	1546	184	88%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	5.268s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	109	98	10%	16–31, 55–103, 120–178, 192–294
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	1546	182	88%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	3.961s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	130	114	12%	11, 15–18, 23, 35–50, 74–122, 139–197, 213–325
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	1567	200	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	4.903s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	130	10	92%	62, 74–75, 159, 227, 273, 291, 295, 307, 320
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	130	114	12%	11, 15–18, 23, 35–50, 74–122, 139–197, 213–325
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	1567	198	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	3.924s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	131	10	92%	62, 74–75, 157, 228, 274, 292, 296, 308, 321
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	130	114	12%	11, 15–18, 23, 35–50, 74–122, 139–197, 213–325
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	1568	200	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	5.008s ⏱️

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
retrack/engine
base.py	71	10	86%	49, 121–148, 152, 159, 162
executor.py	131	10	92%	62, 74–75, 157, 228, 274, 292, 296, 308, 321
request_manager.py	67	7	90%	17, 36, 55, 70–71, 154, 157
rule.py	50	3	94%	87, 109, 116
retrack/nodes
base.py	53	3	94%	104, 111, 114
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
transformers.py	130	114	12%	11, 15–18, 23, 35–50, 74–122, 139–197, 213–325
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	1568	198	87%

Tests	Skipped	Failures	Errors	Time
91	0 💤	0 ❌	0 🔥	3.930s ⏱️