added tests, added two new methods and updated readme