File: groups.rst

package info (click to toggle)
python-globus-sdk 4.3.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,172 kB
  • sloc: python: 35,227; sh: 44; makefile: 35
file content (70 lines) | stat: -rw-r--r-- 1,784 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
Globus Groups
=============

.. currentmodule:: globus_sdk

.. autoclass:: GroupsClient
   :members:
   :member-order: bysource
   :show-inheritance:
   :exclude-members: error_class

Helper Objects
--------------

These helper objects make it easier to create and submit data to a :class:`GroupsClient`.
Additionally, they may be used in concert with the :class:`GroupsManager` to perform
operations.

These enums define values which can be passed to other helpers:

.. autoclass:: GroupMemberVisibility
    :members:
    :undoc-members:

.. autoclass:: GroupRequiredSignupFields
    :members:
    :undoc-members:

.. autoclass:: GroupRole
    :members:
    :undoc-members:

.. autoclass:: GroupVisibility
    :members:
    :undoc-members:

Payload Types
~~~~~~~~~~~~~

A :class:`BatchMembershipActions` defines how to formulate requests to add, remove, or modify
memberships in a group. It can be used to formulate multiple operations to submit in a single
request to the service.

.. autoclass:: BatchMembershipActions
   :members:

A :class:`GroupPolicies` object defines the various policies which can be set on a
group. It can be used with the :class:`GroupsClient` or the :class:`GroupsManager`.

.. autoclass:: GroupPolicies
   :members:

High-Level Client Wrappers
~~~~~~~~~~~~~~~~~~~~~~~~~~

The :class:`GroupsManager` is a high-level helper which wraps a :class:`GroupsClient`. Many common
operations which require assembling a :class:`BatchMembershipActions` and submitting the
result can be achieved with a single method-call on a :class:`GroupsManager`.

.. autoclass:: GroupsManager
   :members:

Client Errors
-------------

When an error occurs, a :class:`GroupsClient` will raise this type of error:

.. autoclass:: GroupsAPIError
   :members:
   :show-inheritance: