Upgrading version to 0.12.0

[dhermes]

@tseaver I'm going to start on the release notes. Can you draft the release notes for logging?

[dhermes]

$ git log -1 --pretty=%H e91d92e6ec5db4b58c251c2d50b86f3d35839390 $ git log 0.11.0..HEAD \ > | grep 'Merge pull request ' \ > | awk -F ' ' '{print $4}' \ > | sort 

yields

#1557
#1562
#1567
#1568
#1569
#1574
#1578
#1579
#1580
#1581
#1582
#1583
#1584
#1585
#1586
#1587
#1588
#1589
#1590
#1592
#1594
#1595
#1596
#1597
#1598
#1599
#1600
#1601
#1602
#1604
#1605
#1606
#1608
#1609
#1610
#1611
#1612
#1613
#1616
#1622
#1626
#1627
#1628
#1630
#1631
#1632
#1633
#1634
#1635
#1638
#1640
#1641
#1642
#1644
#1645
#1646
#1652
#1654
#1658
#1661
#1663
#1664
#1665
#1666
#1667
#1668
#1669
#1674
#1675
#1677
#1678
#1680
#1681
#1682
#1683
#1685
#1686
#1688

[dhermes]

Changes not noted in release notes:

• Bigtable: Splitting Bigtable Row into 3 classes based on the mutation type / RPC method used in commit() #1557, Making common subclass for Bigtable DirectRow and ConditionalRow. #1594, Adding HappyBase system tests for families and counters. #1595, Moving all Bigtable row filters into their own module. #1602, Adding system tests for HappyBase Table.row(). #1604, Adding system tests for HappyBase Table.rows(). #1605, Adding system tests for HappyBase Table.cells() and scan(). #1606, Adding system tests for HappyBase Table.put() and delete(). #1608, Fix Cloud Bigtable scopes. #1631, Adding Bigtable system tests to tox environment (for Py2.7 only). #1635
• Admin: Hide 'six' and 'google.protobuf' from pylint's borked import sniffing. #1582, Hide 'six' and 'google.protobuf' from pylint's borked import sniffing. #1583, Drop look-before-leap use of protobuf-internal type checker. #1626, Typo fix lost merging #1627. #1630, Adding Bigtable system tests to list of default system tests. #1633, Revert "Adding Bigtable system tests to list of default system tests." #1634, Add system tests for topic/subscription IAM policy get/set methods. #1654, Add explicit dep on 'sphinx_rtd_theme' for 'tox -e docs'. #1667, Fix pubsub IAM policy system tests broken by rename. #1686

Release notes:

---

This release contains three large API additions or changes:

• Adds official support for the Google Cloud Bigtable API.
• Adds offficial support of the Google Cloud Logging API.
• Upgrades Google Cloud Datastore from v1beta2 to v1beta3 (see release notes for the new backend)

BigQuery

• Add a template_suffix parameter to BigQuery Table.insert_data (Add a template_suffix parameter to BigQuery Table.insert_data #1562).
• Expand/clarify synchronous query usage docs (Expand/clarify synchronous query usage docs. #1674).
• Cache job constructed for a synchronous query (Cache job constructed for a synchronous query. #1675).

Storage

• Pass mutated properties through to Bucket.create API call (Pass mutated properties through to 'bucket.create' API call. #1579).
• Allow predefined ACL names from either XML or JSON APIs (Allow predefined ACL names from either XML or JSON APIs. #1664).

Pub/Sub

• Add Topic.list_subscriptions (Add 'Topic.list_subscriptions'. #1580).
• Fix topic subscription path patterns (Fix topic subscription path patterns #1592).
• Add Message.service_timestamp property (Add 'Message.service_timestamp' property. #1627).
• Add support for IAM permissions on topics (Add 'Topic.get_iam_policy' API wrapper. #1640, Add 'Topic.set_iam_policy' API wrapper. #1641, Add 'Topic.test_iam_permissions' API wrapper. #1642, Rename 'Topic.test_iam_permissions' -> 'check_iam_permissions.' #1652)
  and subscriptions (Add 'Subscription.get_iam_policy' API wrapper. #1644, Add 'Subscription.set_iam_policy' API wrapper. #1645, Add 'Subscription.test_iam_permissions' API wrapper. #1646)

Datastore

• Upgrade the API from v1beta2 to v1beta3 (see Implement datastore v1beta3 #1288). In particular
• Rename the Query.group_by property to Query.distinct_on
• Add explicit support for null values in entities (Adding support for null and geo point values in v1beta3. #1464)
• Add explicit support for Geo Point values in entities (Adding support for null and geo point values in v1beta3. #1464)
• Remove custom GCLOUD_DATASET_ID environment variable, relying instead on GCLOUD_PROJECT (Removing custom dataset ID environment variable. #1465)
• Fix broken docs for Query.add_filter (Fix broken docs for Query.add_filter #1622).
• Documentation: Support filtering Query by key (Documentation: Filtering Query by key is also possible. #1632).
• Allow bytes or string as project value in datastore clients (Allow bytes or string as project value in datastore clients. #1638).

DNS

• Rename type -> record_type in DNS doc (Renaming type->record_type in DNS doc. #1663).

Logging

• Add support for the Cloud Logging API. See: Add 'Logger.log_text' method. #1567, Add 'Logger.log_struct' #1568, Add 'Client.list_entries'. #1569, Add 'Logger.list_entries'. #1574, Add support for parsing log entries w/ 'protoPayload' from resources #1578, Add 'Logger.delete' method. #1581, Add 'metric.Metric' class and its 'create' API wrapper. #1584, Add 'Metrics.exists' API wrapper. #1585, Add 'Metrics.reload' API wrapper. #1586, Add 'Metrics.update' API wrapper. #1587, Add 'Metrics.delete' API wrapper. #1588, Fix copy-pasta in 'Client.logger' docstring. #1589, Add 'Client.list_metrics' API wrapper. #1590, Add 'Sink.create' API wrapper and 'Client.sink' factory. #1596, Add 'Sink.exists' API wrapper. #1597, Add 'Sink.reload' API wrapper. #1598, Add 'Sink.update' API wrapper. #1599, Add 'Sink.delete' API wrapper. #1600, Add 'Client.list_sinks' API wrapper. #1601, Add system test for 'logger.log_text' and 'logger.log_struct'. #1609, Add system test for 'Client.metric' / 'Metric.create'. #1610, Add system test for 'Client.list_metrics'. #1611, Add system test for 'Metric.reload'. #1612, Add system test for 'Metric.update'. #1613, Fix verb / target for 'Metric.create' / 'Sink.create'. #1616, Add system test for 'Sink.create', w/ Storage bucket destination #1628, Add system test for 'Sink.create' using a Bigquery dataset. #1658, #1577: allow logging protobuf entries #1661, Add 'logger.Batch' for logging multiple entries via a single API call. #1665, Clean up docstring copy-pasta. #1666, Support entry labels #1668, Add support for logging w/ per-request metadata. #1669, Avoid reusing logger name in logging system tests  #1677, Add system test for 'Sink.reload'. #1678, Add system test for 'Sink.create' using a Pubsub topic #1680

[dhermes]

My git log 0.11.0..HEAD command leaves out the merge commits from datastore, but I think #1288 is comprehensive enough that I don't need to increase my git-fu to find them.

[pcostell]

Release notes for Datastore available if you need to link to them: https://cloud.google.com/datastore/release-notes

[dhermes]

Added to the sample above

[tseaver]

@dhermes Since this is the first-ever release, the notes are pretty simple. :)

[dhermes]

Notes look good. LGTY to merge @tseaver?

[tseaver]

LGTM

[dhermes]

@pcostell Tag build started:
https://travis-ci.org/GoogleCloudPlatform/gcloud-python/builds/120188247

That will update gcloud on PyPI and we are officially "launched" at that point.

[pcostell]

Hooray! Thanks @dhermes and @tseaver