Several improvements for library, tests as well as README.

New:
* include/exclude paths
* min/max  number options

Test coverage: 94%