Skip to content
This repository has been archived by the owner on Dec 8, 2021. It is now read-only.

Commit

Permalink
doc: update version and release notes for v1.0.0 (#1431)
Browse files Browse the repository at this point in the history
  • Loading branch information
coryan committed Mar 19, 2020
1 parent 245a482 commit 277b522
Show file tree
Hide file tree
Showing 5 changed files with 59 additions and 10 deletions.
51 changes: 50 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,55 @@
# Changelog

## v0.10.x - TBD
## v1.1.0 - TBD

## v1.0.0 - 2020-03

* **Breaking Changes**

* feat!: add support for QueryOptions (#1351), this is a breaking
change for any developers that used
`Connection::SqlParams::placeholder_do_not_use_name_will_change`.
* feat!: implement SessionPool session refresh (#1425), this is a
breaking change as the return type for
`SessionOptions::keep_alive_interval` changed from
`std::chrono::minutes` to `std::chrono::seconds`.

We believe the risk of developers being impacted by these changes
is small, but do apologize if this impacts you.

* **Other Changes**

* feat: add Managed Backup feature (#1358)
* feat: sessions are automatically created and refreshed by
background threads as described in:
https://cloud.google.com/spanner/docs/sessions#best_practices
* We made multiple improvements (detailed below) to the documentation and
code samples.
* fix: polling policy stops after 'too many' successes (#1427)
* feat: clean up main doxygen page (#1404)
* feat: implement async session creation (#1405)
* fix: avoid deadlocks during shutdown (#1397)
* feat: streaming Value STRING only quotes in aggregates (#1401)
* doc: small improvements to Client samples (#1398)
* doc: link existing example for ExecuteBatchDml (#1395)
* doc: update snippets for all mutation types (#1394)
* fix: Value::op==() correctly handles Date and Timestamp (#1386)
* feat: taught Date how to stream itself (#1385)
* feat: escape non-printable bytes in Value::op<< (#1371)
* docs: add snippets for Commit() with a mutator or mutations (#1374)
* docs: updated snippets and samples for profile and analyze methods (#1364)
* feat: Value streaming respects io manipulators (#1362)
* feat: SqlStatement uses `op<<(Value)` (#1361)
* cleanup: make use of the new Client::Commit(Mutations) overload (#1359)
* feat: add ostream operator for Value (#1336)
* feat: refactor and enhance session creation logic (#1343)
* doc: link to the style guide in the common repo (#1348)
* fix: associate each `Session` with a `Channel` (#1346)
* feat: moved INSTALL.md -> doc/packaging.md (#1341)
* fix: use correct quickstart URL (#1339)
* feat: simplify README.md (#1338)
* doc: add more snippets to documentation (#1331)
* doc: an example of spanner::GetSingularRow (#1327)

## v0.9.x - 2020-03

Expand Down
4 changes: 2 additions & 2 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,8 @@ include(SelectMSVCRuntime)
include(EnableCxxExceptions)

# This should be included from the top level CMakeLists file
set(SPANNER_CLIENT_VERSION_MAJOR 0)
set(SPANNER_CLIENT_VERSION_MINOR 10)
set(SPANNER_CLIENT_VERSION_MAJOR 1)
set(SPANNER_CLIENT_VERSION_MINOR 0)
set(SPANNER_CLIENT_VERSION_PATCH 0)
string(CONCAT SPANNER_CLIENT_VERSION "${SPANNER_CLIENT_VERSION_MAJOR}" "."
"${SPANNER_CLIENT_VERSION_MINOR}" "."
Expand Down
Binary file modified ci/test-api/spanner_client.expected.abi.dump.gz
Binary file not shown.
10 changes: 5 additions & 5 deletions google/cloud/spanner/doc/spanner-main.dox
Original file line number Diff line number Diff line change
Expand Up @@ -127,20 +127,20 @@ there is no value.
The library automatically retries requests that fail with transient errors, and
follows the recommended practices with respect to backoff between retries.
Application developers can override the default
[retry](@ref google::cloud::spanner::v0::RetryPolicy) and
[backoff](@ref google::cloud::spanner::v0::BackoffPolicy) policies.
[retry](@ref google::cloud::spanner::v1::RetryPolicy) and
[backoff](@ref google::cloud::spanner::v1::BackoffPolicy) policies.

The default policies are to continue retrying for up to 15 minutes, and to
use truncated (at 5 minutes) exponential backoff, doubling the maximum backoff
period between retries.

@snippet samples.cc custom-retry-policy

@see [LimitedTimeRetryPolicy](@ref google::cloud::spanner::v0::LimitedTimeRetryPolicy)
and [LimitedErrorCountRetryPolicy](@ref google::cloud::spanner::v0::LimitedErrorCountRetryPolicy)
@see [LimitedTimeRetryPolicy](@ref google::cloud::spanner::v1::LimitedTimeRetryPolicy)
and [LimitedErrorCountRetryPolicy](@ref google::cloud::spanner::v1::LimitedErrorCountRetryPolicy)
for alternative retry policies.

@see [ExponentialBackoffPolicy](@ref google::cloud::spanner::v0::ExponentialBackoffPolicy)
@see [ExponentialBackoffPolicy](@ref google::cloud::spanner::v1::ExponentialBackoffPolicy)
to configure different parameters for the exponential backoff policy.

## Next Steps
Expand Down
4 changes: 2 additions & 2 deletions google/cloud/spanner/version_info.h
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@
#ifndef GOOGLE_CLOUD_CPP_SPANNER_GOOGLE_CLOUD_SPANNER_VERSION_INFO_H
#define GOOGLE_CLOUD_CPP_SPANNER_GOOGLE_CLOUD_SPANNER_VERSION_INFO_H

#define SPANNER_CLIENT_VERSION_MAJOR 0
#define SPANNER_CLIENT_VERSION_MINOR 10
#define SPANNER_CLIENT_VERSION_MAJOR 1
#define SPANNER_CLIENT_VERSION_MINOR 0
#define SPANNER_CLIENT_VERSION_PATCH 0

#endif // GOOGLE_CLOUD_CPP_SPANNER_GOOGLE_CLOUD_SPANNER_VERSION_INFO_H

0 comments on commit 277b522

Please sign in to comment.