From f5e21dd8c25996c62c55c2085dbf6a58e42561aa Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 13:58:36 -0700 Subject: [PATCH 1/7] Add note --- README.md | 7 +++++++ RELEASE_NOTES.md | 21 +++++++++++++++++++++ 2 files changed, 28 insertions(+) diff --git a/README.md b/README.md index 1a7c1f43..5b3877b4 100644 --- a/README.md +++ b/README.md @@ -96,6 +96,13 @@ $ git tag v0.x.y $ git push origin v0.x.y ``` +To generate a release notes, you can use this command line: +``` +$ git log v(last version).. --oneline | cut -f 2- -d ' ' | perl -npe 's/(.*)\(\#([0-9]+)\)/* \1\(\#\2\)\[https:\/\/round-lake.dustinice.workers.dev:443\/http\/github.com\/msgpack\/msgpack-java\/pull\/\2\]/g' +``` + +#### Publishing to Sonatype from Local Machine + If you need to publish to Maven central using a local machine, you need to configure [sbt-sonatype](https://github.com/xerial/sbt-sonatype) plugin. First set Sonatype account information (user name and password) in the global sbt settings. To protect your password, never include this file in your project. ___$HOME/.sbt/(sbt-version)/sonatype.sbt___ diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index e04b4d56..c2766aa5 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,5 +1,26 @@ # Release Notes +## 0.9.0 + +This version support reading and writing [Timestamp values](https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type). +Packer and unpacker interfaces added pack/unpackTimestamp methods. + +Timestamp value in MessagePack is an extention type value whose code is -1. If MessgageUnapcker.unpackValue method is used, +TimestampValue object can be retrieved automatically. If you are using low-level unpack method (e.g., unpackInt, unpackExtension, etc.), +you need to read unpackExtHeader first, and if extHeader.isTimestamp is true, call unpackTimestamp(ext). + +* Timestamp support (#565)[http://github.com/msgpack/msgpack-java/pull/565] + +Dependency updates: +* Update jackson-databind to 2.10.5.1 (#559)[http://github.com/msgpack/msgpack-java/pull/559] + +Internal updates: +* Update akka-actor to 2.6.14 (#579)[http://github.com/msgpack/msgpack-java/pull/579] +* Fix for Scala 2.13 syntax (#577)[http://github.com/msgpack/msgpack-java/pull/577] +* Update airframe-json, airspec to 21.6.0 (#576)[http://github.com/msgpack/msgpack-java/pull/576] +* Update scala-library to 2.13.6 (#568)[http://github.com/msgpack/msgpack-java/pull/568] +* Update sbt to 1.5.3 (#575)[http://github.com/msgpack/msgpack-java/pull/575] + ## 0.8.24 * Rebuild with JDK8 for Android compatibility [#567](https://github.com/msgpack/msgpack-java/pull/567) From e1a739eb8506cbe04006d1dd1084697ce2789ecb Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:25:53 -0700 Subject: [PATCH 2/7] Update release notes --- RELEASE_NOTES.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index c2766aa5..ac1a5842 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -6,10 +6,11 @@ This version support reading and writing [Timestamp values](https://github.com/m Packer and unpacker interfaces added pack/unpackTimestamp methods. Timestamp value in MessagePack is an extention type value whose code is -1. If MessgageUnapcker.unpackValue method is used, -TimestampValue object can be retrieved automatically. If you are using low-level unpack method (e.g., unpackInt, unpackExtension, etc.), -you need to read unpackExtHeader first, and if extHeader.isTimestamp is true, call unpackTimestamp(ext). +TimestampValue object can be retrieved automatically. If you are using low-level unpack methods (e.g., unpackInt, unpackExtension, etc.), +you need to read unpackExtensionHeader first, and if extHeader.isTimestampType is true, call unpackTimestamp(ext). -* Timestamp support (#565)[http://github.com/msgpack/msgpack-java/pull/565] +* Added Timestamp support (#565)[http://github.com/msgpack/msgpack-java/pull/565] and low-level APIs (#580)[https://github.com/msgpack/msgpack-java/pull/580] for +reading timestamp values. Dependency updates: * Update jackson-databind to 2.10.5.1 (#559)[http://github.com/msgpack/msgpack-java/pull/559] From 83fee682a43a7d3ced3ec915b3cbbaec29e213ec Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:27:42 -0700 Subject: [PATCH 3/7] Fix markup --- RELEASE_NOTES.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index ac1a5842..78b2b8fb 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -9,18 +9,18 @@ Timestamp value in MessagePack is an extention type value whose code is -1. If M TimestampValue object can be retrieved automatically. If you are using low-level unpack methods (e.g., unpackInt, unpackExtension, etc.), you need to read unpackExtensionHeader first, and if extHeader.isTimestampType is true, call unpackTimestamp(ext). -* Added Timestamp support (#565)[http://github.com/msgpack/msgpack-java/pull/565] and low-level APIs (#580)[https://github.com/msgpack/msgpack-java/pull/580] for +* Added Timestamp support [#565](http://github.com/msgpack/msgpack-java/pull/565) and low-level APIs [#580](https://github.com/msgpack/msgpack-java/pull/580) for reading timestamp values. Dependency updates: -* Update jackson-databind to 2.10.5.1 (#559)[http://github.com/msgpack/msgpack-java/pull/559] +* Update jackson-databind to 2.10.5.1 [#559](http://github.com/msgpack/msgpack-java/pull/559) Internal updates: -* Update akka-actor to 2.6.14 (#579)[http://github.com/msgpack/msgpack-java/pull/579] -* Fix for Scala 2.13 syntax (#577)[http://github.com/msgpack/msgpack-java/pull/577] -* Update airframe-json, airspec to 21.6.0 (#576)[http://github.com/msgpack/msgpack-java/pull/576] -* Update scala-library to 2.13.6 (#568)[http://github.com/msgpack/msgpack-java/pull/568] -* Update sbt to 1.5.3 (#575)[http://github.com/msgpack/msgpack-java/pull/575] +* Update akka-actor to 2.6.14 [#579](http://github.com/msgpack/msgpack-java/pull/579) +* Fix for Scala 2.13 syntax [#577](http://github.com/msgpack/msgpack-java/pull/577) +* Update airframe-json, airspec to 21.6.0 [#576](http://github.com/msgpack/msgpack-java/pull/576) +* Update scala-library to 2.13.6 [#568](http://github.com/msgpack/msgpack-java/pull/568) +* Update sbt to 1.5.3 [#575](http://github.com/msgpack/msgpack-java/pull/575) ## 0.8.24 From 34ec76c107e66871d4fabfef6aae5e183547841f Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:28:02 -0700 Subject: [PATCH 4/7] Fix script --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5b3877b4..c5af97cd 100644 --- a/README.md +++ b/README.md @@ -98,7 +98,7 @@ $ git push origin v0.x.y To generate a release notes, you can use this command line: ``` -$ git log v(last version).. --oneline | cut -f 2- -d ' ' | perl -npe 's/(.*)\(\#([0-9]+)\)/* \1\(\#\2\)\[https:\/\/round-lake.dustinice.workers.dev:443\/http\/github.com\/msgpack\/msgpack-java\/pull\/\2\]/g' +$ git log v(last version).. --oneline | cut -f 2- -d ' ' | perl -npe 's/(.*)\(\#([0-9]+)\)/* \1\[\#\2\]\(https:\/\/round-lake.dustinice.workers.dev:443\/http\/github.com\/msgpack\/msgpack-java\/pull\/\2\)/g' ``` #### Publishing to Sonatype from Local Machine From 3c71b78e0f3584ae30f08dd8f714c60b455a6add Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:35:08 -0700 Subject: [PATCH 5/7] Add more usage notes --- RELEASE_NOTES.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 78b2b8fb..e2da31c0 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -9,6 +9,12 @@ Timestamp value in MessagePack is an extention type value whose code is -1. If M TimestampValue object can be retrieved automatically. If you are using low-level unpack methods (e.g., unpackInt, unpackExtension, etc.), you need to read unpackExtensionHeader first, and if extHeader.isTimestampType is true, call unpackTimestamp(ext). +When reading Timestamp values, [java.time.Instant](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Instant.html) will be returned. +You can extract unixtime Instant.getEpochSecond(), toEpochMilli (unixtime with milliseconds resolution), and nano-resolution time with Instant.getNano(). + +As TimestampValue is a sub class of ExtensionValue, your code traversing MessagePack data with MessageUnpacker.unpackValue should require no change. + + * Added Timestamp support [#565](http://github.com/msgpack/msgpack-java/pull/565) and low-level APIs [#580](https://github.com/msgpack/msgpack-java/pull/580) for reading timestamp values. From e1d42618339e1d7574f6d998498be0930b24be44 Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:36:27 -0700 Subject: [PATCH 6/7] Fix typo --- RELEASE_NOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index e2da31c0..f13f40e7 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -5,7 +5,7 @@ This version support reading and writing [Timestamp values](https://github.com/msgpack/msgpack/blob/master/spec.md#timestamp-extension-type). Packer and unpacker interfaces added pack/unpackTimestamp methods. -Timestamp value in MessagePack is an extention type value whose code is -1. If MessgageUnapcker.unpackValue method is used, +Timestamp value in MessagePack is an extension type value whose code is -1. If MessgageUnapcker.unpackValue method is used, TimestampValue object can be retrieved automatically. If you are using low-level unpack methods (e.g., unpackInt, unpackExtension, etc.), you need to read unpackExtensionHeader first, and if extHeader.isTimestampType is true, call unpackTimestamp(ext). From 37a10fd0e1784ca03cf11fd01da21833d800fd6e Mon Sep 17 00:00:00 2001 From: "Taro L. Saito" Date: Tue, 8 Jun 2021 14:38:02 -0700 Subject: [PATCH 7/7] Fix description --- RELEASE_NOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index f13f40e7..dc7d19de 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -10,7 +10,7 @@ TimestampValue object can be retrieved automatically. If you are using low-level you need to read unpackExtensionHeader first, and if extHeader.isTimestampType is true, call unpackTimestamp(ext). When reading Timestamp values, [java.time.Instant](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Instant.html) will be returned. -You can extract unixtime Instant.getEpochSecond(), toEpochMilli (unixtime with milliseconds resolution), and nano-resolution time with Instant.getNano(). +You can extract the unixtime with Instant.getEpochSecond(), unixtime with milliseconds resolution with Instant.toEpochMilli(), and nano-resolution time with Instant.getNano(). As TimestampValue is a sub class of ExtensionValue, your code traversing MessagePack data with MessageUnpacker.unpackValue should require no change.