replica-diff

1# replica-diff
2 
3Two tools in this folder, both standard-library Python, no installs:
4 
5```bash
6python3 parity.py replica/features.csv                         # feature parity + missing list
7python3 imgdiff.py replica/screens/S07.png replica/clone-screens/S07.png --out diff-S07.png
8python3 imgdiff.py a.png b.png --json > replica/diffs/S07.json # for parity.py --visual
9python3 parity.py replica/features.csv --visual replica/diffs/*.json --markdown > replica/parity.md
10```
11 
12## What parity means here
13 
14**Parity means it does the same job, not that it looks the same.** The
15feature score is the number that matters: can a user do everything they could
16do in the original. The layout score checks structure (is the information in
17the same places, in the same hierarchy), because that is what makes a switcher
18feel at home. It deliberately ignores colour, because replica-brand changes
19every colour on purpose. Do not chase pixel parity with the original. Its
20exact look is its trade dress, and it changes before launch.
21 
22## Step 1: feature parity
23 
24Make sure `replica/features.csv` is current: every row's `clone` column is
25`yes`, `partial` (with a note), `no`, or `skip` (with a reason). Then:
26 
27```bash
28python3 parity.py replica/features.csv
29```
30 
31It weights must 3, should 2, could 1, counts partial as half, leaves out
32`skip` rows and rows you added that the original does not have, and prints:
33the score, must-haves done of total, each area weakest first, and the missing
34…