deprecate UpdateBackgroundImage and convert DeprecationWarnings to version specifc warnings

Author: jeremylow

tests/test_api_30.py

@@ -1854,3 +1854,10 @@ def testShowFriendship(self):
             twitter.TwitterError,
             lambda: self.api.ShowFriendship(target_screen_name='__jcbl__')
         )
+    @responses.activate
+    def test_UpdateBackgroundImage_deprecation(self):
+        responses.add(responses.POST, DEFAULT_URL, body='{}', status=200)
+        warnings.simplefilter("always")
+        with warnings.catch_warnings(record=True) as w:
+            resp = self.api.UpdateBackgroundImage(image='testdata/168NQ.jpg')
+            self.assertTrue(issubclass(w[0].category, DeprecationWarning))

twitter/api.py

@@ -20,6 +20,7 @@
 from __future__ import division
 from __future__ import print_function
 
+import json
 import sys
 import gzip
 import time
@@ -43,8 +44,17 @@
     from urllib import urlencode
     from urllib import __version__ as urllib_version
 
-from twitter import (__version__, _FileCache, json, DirectMessage, List,
-                     Status, Trend, TwitterError, User, UserStatus, Category)
+from twitter import (
+    __version__,
+    _FileCache,
+    Category,
+    DirectMessage,
+    List,
+    Status,
+    Trend,
+    User,
+    UserStatus,
+)
 
 from twitter.ratelimit import RateLimit
 
@@ -54,6 +64,11 @@
     parse_media_file,
     enf_type)
 
+from twitter.error import (
+    TwitterError,
+    PythonTwitterDeprecationWarning330,
+)
+
 
 warnings.simplefilter('always', DeprecationWarning)
 
@@ -1299,7 +1314,7 @@ def PostMedia(self,
             "PostUpdate() instead. Details of Twitter's deprecation can be "
             "found at: "
             "dev.twitter.com/rest/reference/post/statuses/update_with_media"),
-            DeprecationWarning)
+            PythonTwitterDeprecationWarning330)
 
         url = '%s/statuses/update_with_media.json' % self.base_url
 
@@ -1366,7 +1381,7 @@ def PostMultipleMedia(self, status, media, possibly_sensitive=None,
         warnings.warn((
             "This method is deprecated. Please use PostUpdate instead, "
             "passing a list of media that you would like to associate "
-            "with the updated."), DeprecationWarning, stacklevel=2)
+            "with the update."), PythonTwitterDeprecationWarning330)
         if type(media) is not list:
             raise TwitterError("Must by multiple media elements")
 
@@ -2614,7 +2629,7 @@ def _GetFriendsFollowers(self,
             warnings.warn(
                 "Use of 'cursor' and 'count' parameters are deprecated as of "
                 "python-twitter 3.0. Please use GetFriendsPaged instead.",
-                DeprecationWarning, stacklevel=2)
+                PythonTwitterDeprecationWarning330)
 
         count = 200
         cursor = -1
@@ -4320,6 +4335,10 @@ def UpdateBackgroundImage(self,
                               include_entities=False,
                               skip_status=False):
 
+        warnings.warn((
+            "This method has been deprecated by Twitter as of July 2015 and "
+            "will be removed in future versions of python-twitter."
+            ), PythonTwitterDeprecationWarning330)
         url = '%s/account/update_profile_background_image.json' % (self.base_url)
         with open(image, 'rb') as image_file:
             encoded_image = base64.b64encode(image_file.read())