[v5] update videos, descriptive function naming

Author: anxdpanic

resources/lib/twitch/api/v5/videos.py

@@ -8,25 +8,26 @@
 
 
 @query
-def by_id(video_id):
-    q = Qry('videos/{id}')
-    q.add_urlkw(keys.ID, video_id)
+def get_video(video_id):
+    q = Qry('videos/{video_id}')
+    q.add_urlkw(keys.VIDEO_ID, video_id)
     return q
 
 
 @query
-def top(limit=10, offset=0, game=None, period=Period.WEEK):
+def get_top_videos(limit=10, offset=0, game=None, period=Period.WEEK, broadcast_type=BroadcastType.HIGHLIGHT):
     q = Qry('videos/top')
     q.add_param(keys.LIMIT, limit, 10)
     q.add_param(keys.OFFSET, offset, 0)
     q.add_param(keys.GAME, game)
     q.add_param(keys.PERIOD, Period.validate(period), Period.WEEK)
+    q.add_param(keys.BROADCAST_TYPE, BroadcastType.validate(broadcast_type))
     return q
 
 
 # Needs Authentication
 @query
-def followed(limit=10, offset=0, broadcast_type=BroadcastType.HIGHLIGHT):
+def get_followed_videos(limit=10, offset=0, broadcast_type=BroadcastType.HIGHLIGHT):
     q = Qry('videos/followed')
     q.add_param(keys.LIMIT, limit, 10)
     q.add_param(keys.OFFSET, offset, 0)

resources/lib/twitch/keys.py

@@ -71,4 +71,5 @@
 USER_AGENT_STRING = ('Mozilla/5.0 (Windows NT 6.1; WOW64; rv:6.0) '
                      'Gecko/20100101 Firefox/6.0')
 USER_ID = 'user_id'
+VIDEO_ID = 'video_id'
 VOD = 'vod'