add methods for new readable api