teamId is required for calls to team_memberships.list()

The Cisco Spark docs have been updated to correct the documentation bug
stating that `teamId` was optional for the list team memberships API.

Correct the package, docs and tests to align with the corrected docs.

Author: cmlccie

ciscosparkapi/api/teammemberships.py

@@ -101,13 +101,8 @@ def __init__(self, session):
         self._session = session
 
     @generator_container
-    def list(self, teamId=None, max=None):
-        """Lists all team memberships.
-
-        By default, lists memberships for teams to which the authenticated user
-        belongs.
-
-        Use teamId to list memberships for a team, by ID.
+    def list(self, teamId, max=None):
+        """List team memberships for a team, by ID.
 
         This method supports Cisco Spark's implementation of RFC5988 Web
         Linking to provide pagination support.  It returns a generator
@@ -135,11 +130,10 @@ def list(self, teamId=None, max=None):
 
         """
         # Process args
-        assert teamId is None or isinstance(teamId, basestring)
+        assert isinstance(teamId, basestring)
         assert max is None or isinstance(max, int)
         params = {}
-        if teamId:
-            params['teamId'] = teamId
+        params['teamId'] = teamId
         if max:
             params['max'] = max
         # API request - get items

tests/api/test_teammemberships.py

@@ -76,15 +76,6 @@ def my_team_membership(api, me, team):
         if membership.personId == me.id:
             return membership
 
-# Cisco Spark API Documentation says that you should be able to retrieve a list
-# of all of your team memberships; however, calling the API endpoint without
-# specifying a teamId returns an error (and the docs say that a teamId is
-# required).  #DocumentationBug
-# TODO: Report documentation / API bug on retrieving a user's team memberships
-# @pytest.fixture(scope="session")
-# def authenticated_user_team_memberships(api, team):
-#     return list(api.team_memberships.list())
-
 
 @pytest.fixture(scope="session")
 def make_me_team_moderator(api, my_team_membership):