Update README and add tests for rarity