Add tests for lookups
Update README with a detailed description