Today, we are excited to announce the general availability of our next-generation Ruby helper library.
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.
- 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:
- Getting Started Guide covers installation and how to send your first message.
- Guides and tutorials provide code samples for several use cases.
- Auto-generated library docs are a helpful reference documentation.
- Migration Guide is a great resource, especially if you are familiar with the previous generation. It covers some of the new features and highlights the differences.
The new libraries come in two lines based on our versioning strategy:
- The ’mainline’ contains our GA products and is the most stable release
- ‘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!