Next Generation Ruby Helper Library Release

July 17, 2017
Written by

ruby blog logo

Today, we are excited to announce the general availability of our next-generation Ruby helper library.  

The approach

The Ruby library offers new functionality and takes advantage of modern language features. We’ve rebuilt it from the ground up based on the developer feedback we received from you.

This release concludes the effort of updating our existing libraries to make the helper libraries more consistent, enable faster iteration, and improve the libraries by having a shared foundation across languages. The next-generation SDK family includes PHP, Java, .NET/C#, Python and Node.  

Let’s take a deeper look at the new features of the Ruby library.

What’s new

  • Accessing resources: The new library makes Twilio API subdomains (Lookups, Conversations, Monitor, etc.) first-class citizens. You can now also pin a specific versions of the API.
  • Listing resources: There are now two ways to get a list of resources—list and each.
    • list returns an array that contains the instances of resources.
    • stream returns a generator that efficiently pages the list of resources for you.
  • Paging: Both list and each automatically handle paging for you!
  • Proper types: Resources now serialize/deserialize appropriate types.
  • Error handling: There are new classes to rescue errors from.
  • Configurable HTTP client: You can now plug your own HTTP client into the Twilio client!

How to get started

The are several great resources to help you to get started with the new library:

The new libraries come in two lines based on our versioning strategy:

  1. The ’mainline’ contains our GA products and is the most stable release
  2. ‘edge’ includes new features that are in developer preview or beta.


New functionality will only be added to the new library (Ruby Helper Library 5.x). The old library (4.x) will be officially supported until 10/15/2017. After that day, Twilio will stop providing bug fixes and Support might ask you to upgrade before debugging issues. Learn how to migrate your existing application. The old library will remain available on GitHub.

We can’t wait to see what you build with the new Ruby Helper Library!