Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

docs(dlp): standardize use of 'required', 'optional' in docstrings; add descriptions to enums (via synth) #10103

Merged
merged 1 commit into from
Jan 29, 2020
Merged

docs(dlp): standardize use of 'required', 'optional' in docstrings; add descriptions to enums (via synth) #10103

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 48 additions & 46 deletions dlp/google/cloud/dlp_v2/gapic/dlp_service_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -323,11 +323,11 @@ def inspect_content(

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.ContentItem`
inspect_template_name (str): Optional template to use. Any configuration directly specified in
inspect\_config will override those set in the template. Singular fields
that are set in this request will replace their corresponding fields in
the template. Repeated fields are appended. Singular sub-messages and
groups are recursively merged.
inspect_template_name (str): Template to use. Any configuration directly specified in inspect\_config
will override those set in the template. Singular fields that are set in
this request will replace their corresponding fields in the template.
Repeated fields are appended. Singular sub-messages and groups are
recursively merged.
location_id (str): The geographic location to process content inspection. Reserved for future
extensions.
retry (Optional[google.api_core.retry.Retry]): A retry object used
Expand Down Expand Up @@ -537,12 +537,12 @@ def deidentify_content(

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.ContentItem`
inspect_template_name (str): Optional template to use. Any configuration directly specified in
inspect\_config will override those set in the template. Singular fields
that are set in this request will replace their corresponding fields in
the template. Repeated fields are appended. Singular sub-messages and
groups are recursively merged.
deidentify_template_name (str): Optional template to use. Any configuration directly specified in
inspect_template_name (str): Template to use. Any configuration directly specified in inspect\_config
will override those set in the template. Singular fields that are set in
this request will replace their corresponding fields in the template.
Repeated fields are appended. Singular sub-messages and groups are
recursively merged.
deidentify_template_name (str): Template to use. Any configuration directly specified in
deidentify\_config will override those set in the template. Singular
fields that are set in this request will replace their corresponding
fields in the template. Repeated fields are appended. Singular
Expand Down Expand Up @@ -655,17 +655,17 @@ def reidentify_content(

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.ContentItem`
inspect_template_name (str): Optional template to use. Any configuration directly specified in
inspect_template_name (str): Template to use. Any configuration directly specified in
``inspect_config`` will override those set in the template. Singular
fields that are set in this request will replace their corresponding
fields in the template. Repeated fields are appended. Singular
sub-messages and groups are recursively merged.
reidentify_template_name (str): Template to use. References an instance of ``DeidentifyTemplate``. Any
configuration directly specified in ``reidentify_config`` or
``inspect_config`` will override those set in the template. Singular
fields that are set in this request will replace their corresponding
fields in the template. Repeated fields are appended. Singular
sub-messages and groups are recursively merged.
reidentify_template_name (str): Optional template to use. References an instance of
``DeidentifyTemplate``. Any configuration directly specified in
``reidentify_config`` or ``inspect_config`` will override those set in
the template. Singular fields that are set in this request will replace
their corresponding fields in the template. Repeated fields are
appended. Singular sub-messages and groups are recursively merged.
location_id (str): The geographic location to process content reidentification. Reserved for
future extensions.
retry (Optional[google.api_core.retry.Retry]): A retry object used
Expand Down Expand Up @@ -746,11 +746,11 @@ def list_info_types(
>>> response = client.list_info_types()

Args:
language_code (str): Optional BCP-47 language code for localized infoType friendly
language_code (str): BCP-47 language code for localized infoType friendly
names. If omitted, or if localized strings are not available,
en-US strings will be returned.
filter_ (str): Optional filter to only return infoTypes supported by certain parts of
the API. Defaults to supported\_by=INSPECT.
filter_ (str): filter to only return infoTypes supported by certain parts of the API.
Defaults to supported\_by=INSPECT.
location_id (str): The geographic location to list info types. Reserved for future
extensions.
retry (Optional[google.api_core.retry.Retry]): A retry object used
Expand Down Expand Up @@ -830,7 +830,7 @@ def create_inspect_template(
Args:
parent (str): Required. The parent resource name, for example projects/my-project-id or
organizations/my-org-id.
inspect_template (Union[dict, ~google.cloud.dlp_v2.types.InspectTemplate]): The InspectTemplate to create.
inspect_template (Union[dict, ~google.cloud.dlp_v2.types.InspectTemplate]): Required. The InspectTemplate to create.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.InspectTemplate`
Expand Down Expand Up @@ -1091,9 +1091,9 @@ def list_inspect_templates(
resource, this parameter does not affect the return value. If page
streaming is performed per-page, this determines the maximum number
of resources in a page.
order_by (str): Optional comma separated list of fields to order by, followed by ``asc``
or ``desc`` postfix. This list is case-insensitive, default sorting
order is ascending, redundant space characters are insignificant.
order_by (str): Comma separated list of fields to order by, followed by ``asc`` or
``desc`` postfix. This list is case-insensitive, default sorting order
is ascending, redundant space characters are insignificant.

Example: ``name asc,update_time, create_time desc``

Expand Down Expand Up @@ -1270,7 +1270,7 @@ def create_deidentify_template(
Args:
parent (str): Required. The parent resource name, for example projects/my-project-id or
organizations/my-org-id.
deidentify_template (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyTemplate]): The DeidentifyTemplate to create.
deidentify_template (Union[dict, ~google.cloud.dlp_v2.types.DeidentifyTemplate]): Required. The DeidentifyTemplate to create.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.DeidentifyTemplate`
Expand Down Expand Up @@ -1541,9 +1541,9 @@ def list_deidentify_templates(
resource, this parameter does not affect the return value. If page
streaming is performed per-page, this determines the maximum number
of resources in a page.
order_by (str): Optional comma separated list of fields to order by, followed by ``asc``
or ``desc`` postfix. This list is case-insensitive, default sorting
order is ascending, redundant space characters are insignificant.
order_by (str): Comma separated list of fields to order by, followed by ``asc`` or
``desc`` postfix. This list is case-insensitive, default sorting order
is ascending, redundant space characters are insignificant.

Example: ``name asc,update_time, create_time desc``

Expand Down Expand Up @@ -1727,10 +1727,12 @@ def create_dlp_job(

Args:
parent (str): Required. The parent resource name, for example projects/my-project-id.
inspect_job (Union[dict, ~google.cloud.dlp_v2.types.InspectJobConfig]):
inspect_job (Union[dict, ~google.cloud.dlp_v2.types.InspectJobConfig]): Set to control what and how to inspect.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.InspectJobConfig`
risk_job (Union[dict, ~google.cloud.dlp_v2.types.RiskAnalysisJobConfig]):
risk_job (Union[dict, ~google.cloud.dlp_v2.types.RiskAnalysisJobConfig]): Set to choose what metric to calculate.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.RiskAnalysisJobConfig`
job_id (str): The job id can contain uppercase and lowercase letters, numbers, and
Expand Down Expand Up @@ -1839,14 +1841,14 @@ def list_dlp_jobs(

Args:
parent (str): Required. The parent resource name, for example projects/my-project-id.
filter_ (str): Optional. Allows filtering.
filter_ (str): Allows filtering.

Supported syntax:

- Filter expressions are made up of one or more restrictions.
- Restrictions can be combined by ``AND`` or ``OR`` logical operators.
A sequence of restrictions implicitly uses ``AND``.
- A restriction has the form of ``<field> <operator> <value>``.
- A restriction has the form of ``{field} {operator} {value}``.
- Supported fields/values for inspect jobs:

- ``state`` - PENDING\|RUNNING\|CANCELED\|FINISHED\|FAILED
Expand Down Expand Up @@ -1879,9 +1881,9 @@ def list_dlp_jobs(
streaming is performed per-page, this determines the maximum number
of resources in a page.
type_ (~google.cloud.dlp_v2.types.DlpJobType): The type of job. Defaults to ``DlpJobType.INSPECT``
order_by (str): Optional comma separated list of fields to order by, followed by ``asc``
or ``desc`` postfix. This list is case-insensitive, default sorting
order is ascending, redundant space characters are insignificant.
order_by (str): Comma separated list of fields to order by, followed by ``asc`` or
``desc`` postfix. This list is case-insensitive, default sorting order
is ascending, redundant space characters are insignificant.

Example: ``name asc, end_time asc, create_time desc``

Expand Down Expand Up @@ -2217,9 +2219,9 @@ def list_job_triggers(
resource, this parameter does not affect the return value. If page
streaming is performed per-page, this determines the maximum number
of resources in a page.
order_by (str): Optional comma separated list of triggeredJob fields to order by,
followed by ``asc`` or ``desc`` postfix. This list is case-insensitive,
default sorting order is ascending, redundant space characters are
order_by (str): Comma separated list of triggeredJob fields to order by, followed by
``asc`` or ``desc`` postfix. This list is case-insensitive, default
sorting order is ascending, redundant space characters are
insignificant.

Example: ``name asc,update_time, create_time desc``
Expand All @@ -2232,14 +2234,14 @@ def list_job_triggers(
- ``name``: corresponds to JobTrigger's name.
- ``display_name``: corresponds to JobTrigger's display name.
- ``status``: corresponds to JobTrigger's status.
filter_ (str): Optional. Allows filtering.
filter_ (str): Allows filtering.

Supported syntax:

- Filter expressions are made up of one or more restrictions.
- Restrictions can be combined by ``AND`` or ``OR`` logical operators.
A sequence of restrictions implicitly uses ``AND``.
- A restriction has the form of ``<field> <operator> <value>``.
- A restriction has the form of ``{field} {operator} {value}``.
- Supported fields/values for inspect jobs:

- ``status`` - HEALTHY\|PAUSED\|CANCELLED
Expand Down Expand Up @@ -2580,7 +2582,7 @@ def create_job_trigger(

Args:
parent (str): Required. The parent resource name, for example projects/my-project-id.
job_trigger (Union[dict, ~google.cloud.dlp_v2.types.JobTrigger]): The JobTrigger to create.
job_trigger (Union[dict, ~google.cloud.dlp_v2.types.JobTrigger]): Required. The JobTrigger to create.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.JobTrigger`
Expand Down Expand Up @@ -2670,7 +2672,7 @@ def create_stored_info_type(
Args:
parent (str): Required. The parent resource name, for example projects/my-project-id or
organizations/my-org-id.
config (Union[dict, ~google.cloud.dlp_v2.types.StoredInfoTypeConfig]): Configuration of the storedInfoType to create.
config (Union[dict, ~google.cloud.dlp_v2.types.StoredInfoTypeConfig]): Required. Configuration of the storedInfoType to create.

If a dict is provided, it must be of the same form as the protobuf
message :class:`~google.cloud.dlp_v2.types.StoredInfoTypeConfig`
Expand Down Expand Up @@ -2939,9 +2941,9 @@ def list_stored_info_types(
resource, this parameter does not affect the return value. If page
streaming is performed per-page, this determines the maximum number
of resources in a page.
order_by (str): Optional comma separated list of fields to order by, followed by ``asc``
or ``desc`` postfix. This list is case-insensitive, default sorting
order is ascending, redundant space characters are insignificant.
order_by (str): Comma separated list of fields to order by, followed by ``asc`` or
``desc`` postfix. This list is case-insensitive, default sorting order
is ascending, redundant space characters are insignificant.

Example: ``name asc, display_name, create_time desc``

Expand Down
Loading