Warning, /firebird/pyrobird/tests/cli_commands.md is written in an unsupported language. File is not indexed.
0001 ## Merge
0002
0003 ```bash
0004 pyrobird merge file1.json file2.json [file3.json ...]
0005 ````
0006
0007 Merges two or more Firebird DEX JSON files together.
0008
0009 - Merges entries based on their IDs
0010 - For entries with matching IDs, combines their components together
0011 - By default, the command fails if components with the same name exist in different files
0012 - Special flags control conflict resolution behavior:
0013
0014 4. **Special Flags**:
0015 - `--reset-id` or `-r`: Resets entry IDs to sequential numbers (0,1,2...) so first entries merge, second entries merge, etc.
0016 - `--ignore` or `-i`: When duplicate component names are found, keeps the component from the left file and ignores the right file's component
0017 - `--overwrite` or `-o`: When duplicate component names are found, replaces the left file's component with the right file's component
0018 - `--output` or `-O`: Specifies the output file (default is stdout)
0019
0020
0021 1. **Merge Simulation and Reconstruction Data**:
0022 ```
0023 pyrobird merge simulation.json reconstruction.json -O merged.json
0024 ```
0025
0026 2. **Combine Events with Reset IDs**:
0027 ```
0028 pyrobird merge --reset-id event1.json event2.json event3.json
0029 ```
0030
0031 3. **Merge Files, Ignoring Conflicts**:
0032 ```
0033 pyrobird merge --ignore primary.json secondary.json
0034 ```
0035
0036 4. **Merge Files, Overwriting Components**:
0037 ```
0038 pyrobird merge --overwrite base.json updates.json
0039 ```
0040
0041 The command is flexible and powerful, allowing for various data combination scenarios while providing clear feedback about conflicts and their resolution.
