Add: availability check
Fix: minors feedbacks of pmartin

phpdoc fix
more verbose exception
Add: ignore vim files
Mod: improved tests

factorized code
changed some naming
Merge pull request #1 from oservieres/feature/get-availabilities

Add: availability check