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

[yoshi-automation]

This PR was generated using Autosynth. 🌈

Log from Synthtool

synthtool > Executing /tmpfs/src/git/autosynth/working_repo/dlp/synth.py.
synthtool > Ensuring dependencies.
synthtool > Pulling artman image.
latest: Pulling from googleapis/artman
Digest: sha256:264654a37596a44b0668b8ce6ac41082d713f6ee150b3fc6425fa78cc64e4f20
Status: Image is up to date for googleapis/artman:latest
synthtool > Cloning googleapis.
synthtool > Running generator for google/privacy/dlp/artman_dlp_v2.yaml.
synthtool > Generated code into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/dlp-v2.
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/privacy/dlp/v2/dlp.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/dlp-v2/google/cloud/dlp_v2/proto/dlp.proto
synthtool > Copy: /home/kbuilder/.cache/synthtool/googleapis/google/privacy/dlp/v2/storage.proto to /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/dlp-v2/google/cloud/dlp_v2/proto/storage.proto
synthtool > Placed proto files into /home/kbuilder/.cache/synthtool/googleapis/artman-genfiles/python/dlp-v2/google/cloud/dlp_v2/proto.
synthtool > Replaced 'google\\.cloud\\.privacy\\.dlp_v2' in google/cloud/dlp_v2/proto/dlp_pb2_grpc.py.
synthtool > Replaced 'google\\.cloud\\.privacy\\.dlp_v2' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced 'google\\.cloud\\.privacy\\.dlp_v2' in google/cloud/dlp_v2/proto/storage_pb2.py.
synthtool > Replaced '# Generated by the protocol buffer compiler.  DO NOT EDIT!' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced 'number regex.*\n(\\s+)latex:.*\n' in google/cloud/dlp_v2/proto/storage_pb2.py.
synthtool > Replaced '(hotword_regex:)\n(\\s+Regular expression.*)\n' in google/cloud/dlp_v2/proto/storage_pb2.py.
synthtool > Replaced '(likelihood_adjustment:)\n' in google/cloud/dlp_v2/proto/storage_pb2.py.
synthtool > No replacements made in google/cloud/dlp_v2/proto/dlp_pb2.py for pattern (max_findings_per_item:)
(\s+Max number.*)
(\s+scanned. When.*)
(\s+maximum returned is 1000.*)
(\s+When set within.*)
, maybe replacement is not longer needed?
synthtool > Replaced '(max_findings_per_request:)\n(\\s+Max number of.*)\n(\\s+When set .*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(max_findings_per_info_type:)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(snapshot_inspect_template:)\n(\\s+If run with an .*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(processed_bytes:)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(total_estimated_bytes:)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(info_type_stats:)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(Statistics of how many instances of each info type were found)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(requested_options:)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(sensitive_value_frequency_lower_bound:)\n(\\s+Lower bound.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(sensitive_value_frequency_upper_bound:)\n(\\s+Upper bound.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(bucket_size:)\n(\\s+Total number of equivalence.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(bucket_values:)\n(\\s+Sample of equivalence.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(offset_minutes:)\n(\\s+Set only.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(result:)\n(\\s+A summary of the outcome of this inspect job.)' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(storage_config:)\n(\\s+The data to scan.\n)' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(inspect_config:)\n(\\s+How and what to scan for.\n)' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(inspect_template_name:)\n(\\s+If provided, will be.*)\n(\\s+InspectConfig.*)\n(\\s+values persisted.*)\n(\\s+actions:)\n(\\s+Actions to.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '    (\\s+Set of values defining the equivalence class.*)\n    (\\s+quasi-identifier.*)\n    (\\s+message. The order.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '    (\\s+Size of the equivalence class, for example number of rows with)\n    (\\s+the above set of values.)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(equivalence_class_size_lower_bound:)\n(\\s+Lower bound.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(equivalence_class_size_upper_bound:)\n(\\s+Upper bound.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(bucket_value_count:)\n(\\s+Total number of distinct equivalence.*)\n' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '(value_frequency_lower_bound:)\n\\s+(Lower bound.*)\n\\s+(bucket.\n)(\\s+value_frequency_upper.*)\n\\s+(Upper.*)\n\\s+(bucket.\n)(\\s+bucket_size:)\n\\s+(Total.*\n)(\\s+bucket_values:)\n\\s+(Sample of value.*)\n\\s+(of values.*\n)(\\s+bucket_value_count:)\n\\s+(Total number.*\n)' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > No replacements made in google/cloud/dlp_v2/proto/dlp_pb2.py for pattern (DESCRIPTOR .*_TAGGEDFIELD,
\s+__module__.*
\s+,
\s+__doc__.*
)(\s+field:)
(\s+Identifies .*)
(\s+tag:)
(\s+Semantic.*)
(\s+determine.*)
(\s+reidentifiability.*)
(\s+info_type:)
(\s+A column.*)
(\s+public dataset.*)
(\s+available.*)
(\s+ages.*)
(\s+supported Info.*)
(\s+supported.*)
(\s+custom_tag:)
(\s+A col.*)
(\s+user must.*)
(\s+statist.*)
(\s+\(below.*)
(\s+inferred:)
(\s+If no semantic.*)
, maybe replacement is not longer needed?
synthtool > No replacements made in google/cloud/dlp_v2/proto/dlp_pb2.py for pattern (\s+)__doc__ = """Attributes:, maybe replacement is not longer needed?
synthtool > Replaced '(////////.*)\n\\s+(///////////////\n)' in google/cloud/dlp_v2/proto/dlp_pb2.py.
synthtool > Replaced '^\\s+resource was created.' in google/cloud/dlp_v2/gapic/dlp_service_client.py.
synthtool > Replaced '(\\s+)WHITESPACE \\(int\\).*\n' in google/cloud/dlp_v2/gapic/enums.py.
synthtool > No replacements made in google/cloud/dlp_v2/gapic/enums.py for pattern .*:raw-latex:.*
, maybe replacement is not longer needed?
.coveragerc
.flake8
MANIFEST.in
docs/_static/custom.css
docs/_templates/layout.html
noxfile.py.j2
setup.cfg
Running session blacken
Creating virtual environment (virtualenv) using python3.6 in .nox/blacken
pip install black==19.3b0
black docs google tests noxfile.py setup.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/__init__.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/__init__.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/__init__.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/docs/conf.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/gapic/enums.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/gapic/dlp_service_client_config.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/gapic/transports/dlp_service_grpc_transport.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/proto/dlp_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/proto/storage_pb2_grpc.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/types.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/gapic/dlp_service_client.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/tests/unit/gapic/v2/test_dlp_service_client_v2.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/proto/storage_pb2.py
reformatted /tmpfs/src/git/autosynth/working_repo/dlp/google/cloud/dlp_v2/proto/dlp_pb2.py
All done! ✨ 🍰 ✨
15 files reformatted, 7 files left unchanged.
Session blacken was successful.
synthtool > Wrote metadata to synth.metadata.