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.