Fix method doc signatures for multiline required parameters (#374)
* Fix method doc signatures for multiline required parameters.
Existing doc generator failed to recognize parameters as required when parameter descriptions
extended over more than one line. Besides presenting incorrect information, resulting
inconsistencies broke checks for automated sample generation.
* Regen docs
diff --git a/docs/dyn/genomics_v1.variantsets.html b/docs/dyn/genomics_v1.variantsets.html
index e0b4146..4354c92 100644
--- a/docs/dyn/genomics_v1.variantsets.html
+++ b/docs/dyn/genomics_v1.variantsets.html
@@ -81,7 +81,7 @@
<code><a href="#delete">delete(variantSetId, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a variant set including all variants, call sets, and calls within.</p>
<p class="toc_element">
- <code><a href="#export">export(variantSetId=None, body, x__xgafv=None)</a></code></p>
+ <code><a href="#export">export(variantSetId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Exports variant set data to an external destination.</p>
<p class="toc_element">
<code><a href="#get">get(variantSetId, x__xgafv=None)</a></code></p>
@@ -117,6 +117,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -141,15 +142,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -162,7 +154,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
}
x__xgafv: string, V1 error format.
@@ -178,6 +178,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -202,15 +203,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -223,7 +215,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
}</pre>
</div>
@@ -259,7 +259,7 @@
</div>
<div class="method">
- <code class="details" id="export">export(variantSetId=None, body, x__xgafv=None)</code>
+ <code class="details" id="export">export(variantSetId, body, x__xgafv=None)</code>
<pre>Exports variant set data to an external destination.
For the definitions of variant sets and other genomics resources, see
@@ -273,18 +273,18 @@
The object takes the form of:
{ # The variant data export request.
- "bigqueryDataset": "A String", # Required. The BigQuery dataset to export data to. This dataset must already
- # exist. Note that this is distinct from the Genomics concept of "dataset".
+ "projectId": "A String", # Required. The Google Cloud project ID that owns the destination
+ # BigQuery dataset. The caller must have WRITE access to this project. This
+ # project will also own the resulting export job.
"bigqueryTable": "A String", # Required. The BigQuery table to export data to.
# If the table doesn't exist, it will be created. If it already exists, it
# will be overwritten.
+ "bigqueryDataset": "A String", # Required. The BigQuery dataset to export data to. This dataset must already
+ # exist. Note that this is distinct from the Genomics concept of "dataset".
"callSetIds": [ # If provided, only variant call information from the specified call sets
# will be exported. By default all variant calls are exported.
"A String",
],
- "projectId": "A String", # Required. The Google Cloud project ID that owns the destination
- # BigQuery dataset. The caller must have WRITE access to this project. This
- # project will also own the resulting export job.
"format": "A String", # The format for the exported data.
}
@@ -397,6 +397,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -421,15 +422,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -442,7 +434,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
}</pre>
</div>
@@ -464,6 +464,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -488,15 +489,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -509,7 +501,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
}
updateMask: string, An optional mask specifying which fields to update. Supported fields:
@@ -533,6 +533,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -557,15 +558,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -578,7 +570,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
}</pre>
</div>
@@ -627,6 +627,7 @@
#
# For more genomics resource definitions, see [Fundamentals of Google
# Genomics](https://cloud.google.com/genomics/fundamentals-of-google-genomics)
+ "description": "A String", # A textual description of this variant set.
"name": "A String", # User-specified, mutable name.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata.
@@ -651,15 +652,6 @@
# id and key fields are considered equivalent.
},
],
- "referenceBounds": [ # A list of all references used by the variants in a variant set
- # with associated coordinate upper bounds for each one.
- { # ReferenceBound records an upper bound for the starting coordinate of
- # variants in a particular reference.
- "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
- # variant in the reference sequence.
- "referenceName": "A String", # The name of the reference associated with this reference bound.
- },
- ],
"referenceSetId": "A String", # The reference set to which the variant set is mapped. The reference set
# describes the alignment provenance of the variant set, while the
# `referenceBounds` describe the shape of the actual variant data. The
@@ -672,7 +664,15 @@
# enumerates all possible references: '1', '2', 'X', 'Y', 'MT', etc.
"id": "A String", # The server-generated variant set ID, unique across all variant sets.
"datasetId": "A String", # The dataset to which this variant set belongs.
- "description": "A String", # A textual description of this variant set.
+ "referenceBounds": [ # A list of all references used by the variants in a variant set
+ # with associated coordinate upper bounds for each one.
+ { # ReferenceBound records an upper bound for the starting coordinate of
+ # variants in a particular reference.
+ "upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any
+ # variant in the reference sequence.
+ "referenceName": "A String", # The name of the reference associated with this reference bound.
+ },
+ ],
},
],
}</pre>