Merge pull request #302 from plivo/ha-number

ha number

Author: narayana-plivo

CHANGELOG.md

@@ -1,4 +1,9 @@
 # Change Log
+## [4.59.5](https://github.com/plivo/plivo-python/tree/v4.59.5) (2026-01-21)
+**Feature - HA Number support**
+- Added `ha_enable` optional parameter to PhoneNumber `buy` method for enabling High Availability Number functionality
+- Added `fallback_number` field in PhoneNumber buy response
+
 ## [4.59.4](https://github.com/plivo/plivo-python/tree/v4.59.4) (2026-01-13)
 **Feature - Profile API business_contact_email support**
 - Added `business_contact_email` parameter support to Profile `create` and `update` methods for PUBLIC entity types

plivo/resources/numbers.py

@@ -34,8 +34,9 @@ def __init__(self, client):
         number=[is_phonenumber()],
         app_id=[optional(of_type(six.text_type))],
         verification_info=[optional(of_type_exact(dict))],
-        cnam_lookup=[optional(of_type(six.text_type))],)
-    def buy(self, number, app_id=None, verification_info=None, cnam_lookup=None):
+        cnam_lookup=[optional(of_type(six.text_type))],
+        ha_enable=[optional(of_type(bool))],)
+    def buy(self, number, app_id=None, verification_info=None, cnam_lookup=None, ha_enable=None):
         return self.client.request('POST', ('PhoneNumber', number),
                                    to_param_dict(self.buy, locals()))
 

plivo/version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = '4.59.3'
+__version__ = '4.59.5'

setup.py

@@ -10,7 +10,7 @@
 
 setup(
     name='plivo',
-    version='4.59.4',
+    version='4.59.5',
     description='A Python SDK to make voice calls & send SMS using Plivo and to generate Plivo XML',
     long_description=long_description,
     url='https://github.com/plivo/plivo-python',

tests/resources/fixtures/phoneNumberCreateResponse.json

@@ -4,7 +4,8 @@
   "numbers": [
     {
       "number": "14154009186",
-      "status": "Success"
+      "status": "Success",
+      "fallback_number": "14154009187"
     }
   ],
   "status": "fulfilled"

tests/resources/test_numbers.py

@@ -79,3 +79,10 @@ def test_create(self):
         self.assertUrlEqual(self.client.current_request.url,
                             self.get_url('PhoneNumber', number_id))
         self.assertEqual(self.client.current_request.method, 'POST')
+
+    @with_response(202, method_name='create')
+    def test_create_with_ha_enable(self):
+        self.client.numbers.buy(number_id, app_id='test', ha_enable=True)
+        self.assertUrlEqual(self.client.current_request.url,
+                            self.get_url('PhoneNumber', number_id))
+        self.assertEqual(self.client.current_request.method, 'POST')