Prepare v0.40.0

[jdpedrie]

Please take a moment to review and make sure I covered everything! This is a big one.

PLEASE MERGE #707 FIRST

---

Google Cloud PHP v0.40.0

Thank you to everyone for your help and patience on this release. Please take the time to read and understand this document, particularly if you are using Cloud BigQuery! While we made more breaking changes than normal, we believe they position us well for the future, and we look forward to hearing your feedback!

Cloud Core v1.10.0

• Google\Cloud\Core\ServiceBuilder now throws \Exception when a service is requested but is not installed. (ensures servicebuilder throws proper exceptions #682)
• Updated retry setting configuration. (Refresh gapics #679)
• Added Google\Cloud\Core\ConcurrencyControlTrait, used to apply If-Match headers to outgoing REST requests. (Add support for etags on bigquery tables and datasets #634)

Cloud BigQuery v0.3.0

• Google\Cloud\BigQuery\BigQueryClient::runQuery() now polls a job and returns only when the query is complete. (Run query and wait for it to complete #604)
• Added support for etags on Datasets and Tables for concurrency control. (Add support for etags on bigquery tables and datasets #634)
• ❗ BREAKING CHANGE BigQuery Queries now use Standard SQL by default. ([BC Break] Switch to standard SQL by default #640)
• Google Cloud PHP's BigQuery client will now generate Job IDs in the client, with optional user-specified prefixes. (Generate BigQuery Job ID on client side with optional prefix #643)
• Added Google\Cloud\BigQuery\Job::waitUntilComplete(). It is no longer necessary to poll for job completion. ([BC Break] Implement waitUntilComplete and block while waiting for query results #642)
• The return value of Google\Cloud\BigQuery\Job::queryResults() will block when first iterated, or when any rows are accessed. ([BC Break] Implement waitUntilComplete and block while waiting for query results #642)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\QueryResults::isComplete() has been marked @internal. This means it is not intended for use outside of the library. ([BC Break] Implement waitUntilComplete and block while waiting for query results #642)
• Google\Cloud\BigQuery\QueryResults now implements IteratorAggregate, and can be iterated over directly. ([BC Break] Implement waitUntilComplete and block while waiting for query results #642)
• Added CopyJobConfiguration, ExtractJobConfiguration, LoadJobConfiguration, QueryJobConfiguration classes to Google\Cloud\BigQuery to assist in configuration different types of Jobs. (Introduce remaining BigQuery to GA items #686).
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\runQuery() now uses jobs.insert instead of jobs.query and accepts an instance of Google\Cloud\BigQuery\QueryJobConfiguration as its first argument. ([BC Break] Implement waitUntilComplete and block while waiting for query results #642, Introduce remaining BigQuery to GA items #686)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\BigQueryClient::runQueryAsJob() has been removed in favor of startQuery(). startQuery() accepts an instance of Google\Cloud\BigQuery\QueryJobConfiguration as its first argument. (Introduce remaining BigQuery to GA items #686)
• Added Google\Cloud\BigQuery\Table::startJob() to start an asynchronous Job. (Introduce remaining BigQuery to GA items #686)
• Added Google\Cloud\BigQuery\Table::runJob() to start a synchronous Job. (Introduce remaining BigQuery to GA items #686)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\Table::copy() now returns an instance of Google\Cloud\BigQuery\CopyJobConfiguration which can be used with startJob() or runJob(). (Introduce remaining BigQuery to GA items #686)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\Table::export() has been renamed extract() now returns an instance of Google\Cloud\BigQuery\ExportJobConfiguration which can be used with startJob() or runJob(). (Introduce remaining BigQuery to GA items #686)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\Table::load() now returns an instance of Google\Cloud\BigQuery\LoadJobConfiguration which can be used with startJob() or runJob(). (Introduce remaining BigQuery to GA items #686)
• ❗ BREAKING CHANGE Google\Cloud\BigQuery\Table::loadFromStorage() now returns an instance of Google\Cloud\BigQuery\LoadJobConfiguration which can be used with startJob() or runJob(). (Introduce remaining BigQuery to GA items #686)
• Google\Cloud\BigQuery\Table::insertRows() now supports an optional configuration option, $options.autoCreate, which, if enabled, will attempt to automatically create the table if it does not exist. (Introduce remaining BigQuery to GA items #686)

Cloud DLP v0.2.0

• Refreshed GAPIC Client Documentation (Refresh GAPIC documentation #677)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Error Reporting v0.5.0

• Renamed internal references to $psrBatchLogger to $psrLogger. (renames psrBatchLogger to psrLogger #690)
• Exception handler now reports service and version. (adds service and version to exception handling #689)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Language v0.6.0

• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679, Require google/gax and google/proto-client in grpc components #707)

Cloud Logging v1.5.0

• Refreshed GAPIC Client Documentation (Refresh GAPIC documentation #677)
• Fixed a bug with PSR log levels in gRPC transport. (ensures PSR log level can be int or string #684)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Monitoring v0.5.0

• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Pub/Sub v0.8.0

• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Spanner v0.7.0

• Refreshed GAPIC Client Documentation (Refresh GAPIC documentation #677)
• Implemented automatic downsizing of session pool when request volume does not necessitate a full pool. (Implement automatic downsizing of session pool #646)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Speech v0.8.0

• Refreshed GAPIC Client Documentation (Refresh GAPIC documentation #677)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679, Require google/gax and google/proto-client in grpc components #707)

Cloud Storage v1.2.0

• Introduced support for Pub/Sub Notifications. (Introduce Pub\Sub bucket notifications #680)
• Added support for requester pays and requester project to remaining methods. (Update discovery document and documentation for Requester Pays #694)
• Added projectId() method to Google\Cloud\Storage\Connection\Rest. (Provide project ID in storage connection #681)

Cloud VideoIntelligence v0.5.0

• Refreshed GAPIC Client Documentation (Refresh GAPIC documentation #677)
• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679)

Cloud Vision v0.5.0

• Refreshed GAPIC Client and updated dependency version to latest releases of google/gax and google/proto-client. (Refresh gapics #679, Require google/gax and google/proto-client in grpc components #707)

[dwsupplee]

Really nice work hitting all the details on this one! One small item:

"Google\Cloud\BigQuery\Job::queryResults() now blocks until the query is complete"

This has since changed, instead now it only blocks when attempting to access the rows associated with the query.

[jdpedrie]

@dwsupplee would this be a more accurate summation?

• The return value of Google\Cloud\BigQuery\Job::queryResults() will block when first iterated, or when any rows are accessed.

[dwsupplee]

Sounds good, thanks!