Fixes to extend logic and label validation

[hdoupe]

• Updates for edge cases in extend logic when directly using the extend method and setting label_to_extend_values.

  • Case 1: label_to_extend values is an empty list:

    params = ExtParams()
    init = params.select_eq("extend_param")
    params.extend(label_to_extend="d0", label_to_extend_values=[])
    assert init == params.select_eq("extend_param")

  • Case 2: label_to_extend_values are all values greater than the defined values:

    params = ExtParams()
    params.extend(label_to_extend="d0", label_to_extend_values=[8, 9, 10])
    params.sort_values()
    assert params.extend_param == [
    {"d0": 2, "d1": "c1", "value": 1},
    {"d0": 2, "d1": "c2", "value": 2},
    {"d0": 3, "d1": "c1", "value": 3},
    {"d0": 3, "d1": "c2", "value": 4},
    {"d0": 5, "d1": "c1", "value": 5},
    {"d0": 5, "d1": "c2", "value": 6},
    {"d0": 7, "d1": "c1", "value": 7},
    {"d0": 7, "d1": "c2", "value": 8},
    {"d0": 8, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 8, "d1": "c2", "value": 8, "_auto": True},
    {"d0": 9, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 9, "d1": "c2", "value": 8, "_auto": True},
    {"d0": 10, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 10, "d1": "c2", "value": 8, "_auto": True},
    ]

  • Case 3: Some extend values are less than the defined values:

    params = ExtParams()
    params.extend(
    label_to_extend="d0", label_to_extend_values=[0, 8, 9, 10]
    )
    params.sort_values()
    assert params.extend_param == [
    {"d0": 0, "d1": "c1", "value": 1, "_auto": True},
    {"d0": 0, "d1": "c2", "value": 2, "_auto": True},
    {"d0": 2, "d1": "c1", "value": 1},
    {"d0": 2, "d1": "c2", "value": 2},
    {"d0": 3, "d1": "c1", "value": 3},
    {"d0": 3, "d1": "c2", "value": 4},
    {"d0": 5, "d1": "c1", "value": 5},
    {"d0": 5, "d1": "c2", "value": 6},
    {"d0": 7, "d1": "c1", "value": 7},
    {"d0": 7, "d1": "c2", "value": 8},
    {"d0": 8, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 8, "d1": "c2", "value": 8, "_auto": True},
    {"d0": 9, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 9, "d1": "c2", "value": 8, "_auto": True},
    {"d0": 10, "d1": "c1", "value": 7, "_auto": True},
    {"d0": 10, "d1": "c2", "value": 8, "_auto": True},
    ]

• Minor performance improvements from defining comparison functions for each marshmallow field. This means that integer, float, and date can use the > operator for look ups in the adjust and extend method instead of comparing values' indices in the extend_grid.
• A new parse_labels method for validating label values that are set by the user via set_state or extend.

[hdoupe]

While I was working on this PR, I went ahead and updated the type signatures and doc strings for public methods like adjust and set_state.

I also made an API change on the extend method so that instead of label_to_extend and label_to_extend_values the more concise label and label_values are used. This will be one of the last breaking API changes now that more of PT's methods besides adjust and set_state are being used by other projects.