Specification for Merge Python Dictionaries

Software Requirement: Name of the tool: merge_dicts SWRQ_TOOL_merge_dicts

status: verified test_status: verified_passed generated by: EVAL_STAKE_MISSING_NAME is satisfied by: P_MERGE_DICTS, M_MERGE_DICTS tested by: TS_MERGE_DICTS

The tool / script shall be defined as merge_dicts.

Software Requirement: Merge python dictionaries SWRQ_MERGE_DICTS

status: verified test_status: verified_passed generated by: EVAL_STAKE_MANY_DICTS satisfies: CSTRQ_MERGE_DICTS is satisfied by: P_MERGE_DICTS, M_MERGE_DICTS, IF_MERGE_DICTS tested by: TS_MERGE_DICTS

The python module merge_dicts shall provide a function to merge a list of python dictionaries to one dictionary.

Software Requirement: Definition: list of dictionaries SWRQ_LIST_OF_DICTS

status: verified test_status: verified_passed child needs: VERIFY_SWRQ_LIST_OF_DICTS generated by: EVAL_STAKE_MANY_DICTS, EVAL_STAKE_MISSING_INVALID_INPUT satisfies: CSTRQ_MERGE_DICTS is satisfied by: P_MERGE_DICTS tested by: TS_MERGE_DICTS

The above defined function to merge dictionaries shall treat list as: none, one, two or many dictionaries organized in a list. Verification Information: Test function with appropriate number of dictionaries VERIFY_SWRQ_LIST_OF_DICTS parent needs: SWRQ_LIST_OF_DICTS tested by: TS_MERGE_DICTS Test function with: empty list one dictionary in the list two dictionary in the list three dictionary in the list (many) With python it is difficult to test the upper bound.

Software Requirement: Detect merge conflicts SWRQ_DETECT_MERGE_CONFLICTS

status: verified test_status: verified_passed child needs: VERIFY_SWRQ_DETECT_MERGE_CONFLICTS satisfies: CSTRQ_DETECT_MERGE_CONFLICTS is satisfied by: P_MERGE_DICTS, IF_MERGE_DICTS tested by: TS_MERGE_DICTS

As multiple dictionaries could have for the same Key different defined Values, merge_dicts shall report merge conflicts. Verification Information: test merge conflict is indicated. VERIFY_SWRQ_DETECT_MERGE_CONFLICTS parent needs: SWRQ_DETECT_MERGE_CONFLICTS tested by: TS_MERGE_DICTS Verify that merge_dicts reports a merge conflict if different values but same key in dictionaries are provided.

Software Requirement: Allow double definitions of same Key / Value SWRQ_ALLOW_DOUBLE_DEFINITION

status: verified test_status: verified_passed child needs: VERIFY_SWRQ_ALLOW_DOUBLE_DEFINITION generated by: EVAL_STAKE_DOUBLE_DEFINITON_ALLOWED satisfies: CSTRQ_DETECT_MERGE_CONFLICTS is satisfied by: P_MERGE_DICTS, IF_MERGE_DICTS tested by: TS_MERGE_DICTS

The definition of the same Key/Value Pair is allowed and shall not reported as a merge conflict. Verification Information: Allow double definition VERIFY_SWRQ_ALLOW_DOUBLE_DEFINITION parent needs: SWRQ_ALLOW_DOUBLE_DEFINITION tested by: TS_MERGE_DICTS Verify with a test case, that a double definition of a Key / Value pair lead not to a merge conflict indication.

Software Requirement: Output in merge conflict case SWRQ_USE_FIRST_VALUE_FOR_KEY

status: verified test_status: verified_passed child needs: VERIFY_SWRQ_USE_FIRST_VALUE_FOR_KEY generated by: EVAL_STAKE_OUTPUT_CONFLICT satisfies: CSTRQ_DETECT_MERGE_CONFLICTS is satisfied by: P_MERGE_DICTS, IF_MERGE_DICTS tested by: TS_MERGE_DICTS

If we have the same key in two dictionaries but different content, the first defined value shall be in the final dictionary. Verification Information: Output in merge conflict case VERIFY_SWRQ_USE_FIRST_VALUE_FOR_KEY parent needs: SWRQ_USE_FIRST_VALUE_FOR_KEY tested by: TS_MERGE_DICTS Verify with a test case: Use merge function with double defined Key/Value Test that values from the first element in the list are in the output.