Skip to content

Commit aed19be

Browse files
committed
Updated spec
1 parent 86d1c55 commit aed19be

File tree

14 files changed

+975
-317
lines changed

14 files changed

+975
-317
lines changed

dropbox/auth.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -357,7 +357,7 @@ def retry_after(self):
357357
The number of seconds that the app should wait before making another
358358
request.
359359
360-
:rtype: long
360+
:rtype: int
361361
"""
362362
if self._retry_after_present:
363363
return self._retry_after_value

dropbox/base.py

Lines changed: 159 additions & 71 deletions
Large diffs are not rendered by default.

dropbox/base_team.py

Lines changed: 35 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,8 @@ def team_devices_list_members_devices(self,
229229
include_desktop_clients=True,
230230
include_mobile_clients=True):
231231
"""
232-
List all device sessions of a team.
232+
List all device sessions of a team. Permission : Team member file
233+
access.
233234
234235
:param Nullable cursor: At the first call to the
235236
:meth:`team_devices_list_members_devices` the cursor shouldn't be
@@ -266,7 +267,8 @@ def team_devices_list_team_devices(self,
266267
include_desktop_clients=True,
267268
include_mobile_clients=True):
268269
"""
269-
List all device sessions of a team.
270+
List all device sessions of a team. Permission : Team member file
271+
access.
270272
271273
:param Nullable cursor: At the first call to the
272274
:meth:`team_devices_list_team_devices` the cursor shouldn't be
@@ -491,7 +493,7 @@ def team_groups_list(self,
491493
"""
492494
Lists groups on a team. Permission : Team Information.
493495
494-
:param long limit: Number of results to return per call.
496+
:param int limit: Number of results to return per call.
495497
:rtype: :class:`dropbox.team.GroupsListResult`
496498
"""
497499
arg = team.GroupsListArg(limit)
@@ -564,7 +566,7 @@ def team_groups_members_list(self,
564566
565567
:param group: The group whose members are to be listed.
566568
:type group: :class:`dropbox.team.GroupSelector`
567-
:param long limit: Number of results to return per call.
569+
:param int limit: Number of results to return per call.
568570
:rtype: :class:`dropbox.team.GroupsMembersListResult`
569571
:raises: :class:`.exceptions.ApiError`
570572
@@ -863,7 +865,7 @@ def team_member_space_limits_excluded_users_list(self,
863865
"""
864866
List member space limits excluded users.
865867
866-
:param long limit: Number of results to return per call.
868+
:param int limit: Number of results to return per call.
867869
:rtype: :class:`dropbox.team.ExcludedUsersListResult`
868870
:raises: :class:`.exceptions.ApiError`
869871
@@ -1073,7 +1075,7 @@ def team_members_list(self,
10731075
"""
10741076
Lists members of a team. Permission : Team information.
10751077
1076-
:param long limit: Number of results to return per call.
1078+
:param int limit: Number of results to return per call.
10771079
:param bool include_removed: Whether to return removed members.
10781080
:rtype: :class:`dropbox.team.MembersListResult`
10791081
:raises: :class:`.exceptions.ApiError`
@@ -1426,7 +1428,7 @@ def team_namespaces_list(self,
14261428
folders may be owned by other users or other teams. Duplicates may occur
14271429
in the list.
14281430
1429-
:param long limit: Specifying a value here has no effect.
1431+
:param int limit: Specifying a value here has no effect.
14301432
:rtype: :class:`dropbox.team.TeamNamespacesListResult`
14311433
:raises: :class:`.exceptions.ApiError`
14321434
@@ -1470,6 +1472,15 @@ def team_properties_template_add(self,
14701472
name,
14711473
description,
14721474
fields):
1475+
"""
1476+
Permission : Team member file access.
1477+
1478+
:rtype: :class:`dropbox.team.AddTemplateResult`
1479+
:raises: :class:`.exceptions.ApiError`
1480+
1481+
If this raises, ApiError will contain:
1482+
:class:`dropbox.team.ModifyTemplateError`
1483+
"""
14731484
warnings.warn(
14741485
'properties/template/add is deprecated.',
14751486
DeprecationWarning,
@@ -1488,6 +1499,8 @@ def team_properties_template_add(self,
14881499
def team_properties_template_get(self,
14891500
template_id):
14901501
"""
1502+
Permission : Team member file access.
1503+
14911504
:param str template_id: An identifier for template added by route See
14921505
:meth:`team_templates_add_for_user` or
14931506
:meth:`team_templates_add_for_team`.
@@ -1511,6 +1524,15 @@ def team_properties_template_get(self,
15111524
return r
15121525

15131526
def team_properties_template_list(self):
1527+
"""
1528+
Permission : Team member file access.
1529+
1530+
:rtype: :class:`dropbox.team.ListTemplateResult`
1531+
:raises: :class:`.exceptions.ApiError`
1532+
1533+
If this raises, ApiError will contain:
1534+
:class:`dropbox.team.TemplateError`
1535+
"""
15141536
warnings.warn(
15151537
'properties/template/list is deprecated.',
15161538
DeprecationWarning,
@@ -1530,6 +1552,8 @@ def team_properties_template_update(self,
15301552
description=None,
15311553
add_fields=None):
15321554
"""
1555+
Permission : Team member file access.
1556+
15331557
:param str template_id: An identifier for template added by See
15341558
:meth:`team_templates_add_for_user` or
15351559
:meth:`team_templates_add_for_team`.
@@ -1769,7 +1793,7 @@ def team_team_folder_list(self,
17691793
"""
17701794
Lists all team folders. Permission : Team member file access.
17711795
1772-
:param long limit: The maximum number of results to return per request.
1796+
:param int limit: The maximum number of results to return per request.
17731797
:rtype: :class:`dropbox.team.TeamFolderListResult`
17741798
:raises: :class:`.exceptions.ApiError`
17751799
@@ -1918,9 +1942,9 @@ def team_log_get_events(self,
19181942
</developers/documentation/http/teams#team-features-get_values>`_ to
19191943
check for this feature. Permission : Team Auditing.
19201944
1921-
:param long limit: The maximal number of results to return per call.
1922-
Note that some calls may not return ``limit`` number of events, and
1923-
may even return no events, even with `has_more` set to true. In this
1945+
:param int limit: The maximal number of results to return per call. Note
1946+
that some calls may not return ``limit`` number of events, and may
1947+
even return no events, even with `has_more` set to true. In this
19241948
case, callers should fetch again using
19251949
:meth:`team_log_get_events_continue`.
19261950
:param Nullable account_id: Filter the events by account ID. Return ony

dropbox/common.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -382,7 +382,7 @@ def __repr__(self):
382382
DisplayName_validator = bv.String(min_length=1, pattern=u'[^/:?*<>"|]*')
383383
DisplayNameLegacy_validator = bv.String()
384384
DropboxTimestamp_validator = bv.Timestamp(u'%Y-%m-%dT%H:%M:%SZ')
385-
EmailAddress_validator = bv.String(max_length=255, pattern=u"^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*.[A-Za-z]{2,15}$")
385+
EmailAddress_validator = bv.String(max_length=255, pattern=u"^['&A-Za-z0-9._%+-]+@[A-Za-z0-9-][A-Za-z0-9.-]*\\.[A-Za-z]{2,15}$")
386386
# A ISO639-1 code.
387387
LanguageCode_validator = bv.String(min_length=2)
388388
NamePart_validator = bv.String(min_length=1, max_length=100, pattern=u'[^/:?*<>"|]*')

dropbox/file_requests.py

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ class CreateFileRequestArgs(bb.Struct):
3434
files will be sent. For apps with the app folder permission, this will
3535
be relative to the app folder.
3636
:ivar deadline: The deadline for the file request. Deadlines can only be set
37-
by Pro and Business accounts.
37+
by Professional and Business accounts.
3838
:ivar open: Whether or not the file request should be open. If the file
3939
request is closed, it will not accept any file submissions, but it can
4040
be opened later.
@@ -126,8 +126,8 @@ def destination(self):
126126
@property
127127
def deadline(self):
128128
"""
129-
The deadline for the file request. Deadlines can only be set by Pro and
130-
Business accounts.
129+
The deadline for the file request. Deadlines can only be set by
130+
Professional and Business accounts.
131131
132132
:rtype: FileRequestDeadline
133133
"""
@@ -625,7 +625,7 @@ def file_count(self):
625625
"""
626626
The number of files this file request has received.
627627
628-
:rtype: long
628+
:rtype: int
629629
"""
630630
if self._file_count_present:
631631
return self._file_count_value
@@ -979,7 +979,8 @@ class UpdateFileRequestArgs(bb.Struct):
979979
:ivar destination: The new path of the folder in the Dropbox where uploaded
980980
files will be sent. For apps with the app folder permission, this will
981981
be relative to the app folder.
982-
:ivar deadline: The new deadline for the file request.
982+
:ivar deadline: The new deadline for the file request. Deadlines can only be
983+
set by Professional and Business accounts.
983984
:ivar open: Whether to set this file request as open or closed.
984985
"""
985986

@@ -1105,7 +1106,8 @@ def destination(self):
11051106
@property
11061107
def deadline(self):
11071108
"""
1108-
The new deadline for the file request.
1109+
The new deadline for the file request. Deadlines can only be set by
1110+
Professional and Business accounts.
11091111
11101112
:rtype: UpdateFileRequestDeadline
11111113
"""

0 commit comments

Comments
 (0)