docs(General): Update the CHANGELOG, README, Javadoc adn project version

Author: Georgi Neykov

CHANGELOG.md

@@ -1,6 +1,48 @@
 Changelog
 ==========
 
+Version 2.3.0 (23.10.2019)
+--------------------------
+
+#### Composer
+
+- Add the `methodName()` property to `Call<T>` to allow for better error reporting.
+- Add the API method name in the stacktrace when an error is thrown via an `Observable` created with a RxJava adapter.
+- Add the ability to override the target endpoint of a `Call<T>` is being made by adding a single `Endpoint` method
+ parameter. Example: 
+     ```java
+    interface MyInterface {
+        @Method("someapicall")
+        Call<ResponseBody> getResponseBody(Endpoint endpoint);
+    
+        @Method("someapicallwithparams")
+        Call<ResponseBody> getResponseBody(@Request SomeRequest request, Endpoint endpoint);
+    }
+    ```   
+  - Extract the composer-related annotations in a separate module and the `composer-annotations`  maven artifact.
+  
+#### Client
+
+- Add an `endpoint()` property to `ResponseData` that returns the source `Endpoint`.
+
+#### Serialization
+
+- Give a better error message when trying to serialize a type as a request parameter not resulting in a single value.
+
+#### Protocol
+
+- Update to Okio 1.17.4
+- Drop the peeking source implementation in favor of the one shipped with Okio.
+- `BytesReader` instances returned from `BytesReader.peek()` will not close their parent when being closed.
+- `BytesReader` instances returned from `BytesReader.peek()` will throw exceptions if used when their
+parent has bytes consumed beyond the peek start point.
+
+#### General
+
+- Update to Gradle 5.6.2
+- Refactor the project build scripts
+
+
 Version 2.2.3 (19.09.2018)
 --------------------------
 
@@ -107,11 +149,11 @@ Example:
 
 Calling:
 ```java
-	collectionAdapter.serialize(writer, collection);
+   collectionAdapter.serialize(writer, collection);
 ```
 is equivalent to:
 ```java
-    writer.writeValue("some value,some value,some value");
+writer.writeValue("some value,some value,some value");
 ```
 
 #### Composer

README.md

@@ -59,13 +59,13 @@ api.copy(...)
 <dependency>
   <groupId>com.pcloud.pcloud-networking-java</groupId>
   <artifactId>composer</artifactId>
-  <version>2.2.3</version>
+  <version>2.3.0</version>
   <type>pom</type>
 </dependency>
 ```
 
 ```groovy
-compile 'com.pcloud.pcloud-networking-java:composer:2.2.3'
+compile 'com.pcloud.pcloud-networking-java:composer:2.3.0'
 ```
 
 ### Client
@@ -87,13 +87,13 @@ The `binapi-client` module contains a network client for composing and executing
 <dependency>
   <groupId>com.pcloud.pcloud-networking-java</groupId>
   <artifactId>binapi-client</artifactId>
-  <version>2.2.3</version>
+  <version>2.3.0</version>
   <type>pom</type>
 </dependency>
 ```
 
 ```groovy
-compile 'com.pcloud.pcloud-networking-java:binapi-client:2.2.3'
+compile 'com.pcloud.pcloud-networking-java:binapi-client:2.3.0'
 ```
 
 --------------------------------------------------------------------------------
@@ -115,13 +115,13 @@ The `serialization` module contains a library for serializing Java objects to bi
 <dependency>
   <groupId>com.pcloud.pcloud-networking-java</groupId>
   <artifactId>serialization</artifactId>
-  <version>2.2.3</version>
+  <version>2.3.0</version>
   <type>pom</type>
 </dependency>
 ```
 
 ```groovy
-compile 'com.pcloud.pcloud-networking-java:serialization:2.2.3'
+compile 'com.pcloud.pcloud-networking-java:serialization:2.3.0'
 ```
 --------------------------------------------------------------------------------
 ### Protocol
@@ -142,13 +142,13 @@ The `protocol` module contains the core logic for writing/reading data in the fo
 <dependency>
   <groupId>com.pcloud.pcloud-networking-java</groupId>
   <artifactId>protocol</artifactId>
-  <version>2.2.3</version>
+  <version>2.3.0</version>
   <type>pom</type>
 </dependency>
 ```
 
 ```groovy
-compile 'com.pcloud.pcloud-networking-java:protocol:2.2.3'
+compile 'com.pcloud.pcloud-networking-java:protocol:2.3.0'
 ```
 
 

docs/allclasses-frame.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_91) on Fri Mar 23 19:14:27 EET 2018 -->
+    <!-- Generated by javadoc (1.8.0_91) on Wed Oct 23 16:41:34 EEST 2019 -->
 <title>All Classes</title>
-<meta name="date" content="2018-03-23">
+    <meta name="date" content="2019-10-23">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -28,7 +28,6 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/api/DataApiResponse.html" title="class in com.pcloud.networking.api" target="classFrame">DataApiResponse</a></li>
 <li><a href="com/pcloud/networking/protocol/DataSink.html" title="class in com.pcloud.networking.protocol" target="classFrame">DataSink</a></li>
 <li><a href="com/pcloud/networking/protocol/DataSource.html" title="class in com.pcloud.networking.protocol" target="classFrame">DataSource</a></li>
-<li><a href="com/pcloud/networking/client/internal/tls/DefaultHostnameVerifier.html" title="class in com.pcloud.networking.client.internal.tls" target="classFrame">DefaultHostnameVerifier</a></li>
 <li><a href="com/pcloud/networking/client/Endpoint.html" title="class in com.pcloud.networking.client" target="classFrame">Endpoint</a></li>
 <li><a href="com/pcloud/networking/client/EndpointProvider.html" title="interface in com.pcloud.networking.client" target="classFrame"><span class="interfaceName">EndpointProvider</span></a></li>
 <li><a href="com/pcloud/networking/protocol/ForwardingProtocolReader.html" title="class in com.pcloud.networking.protocol" target="classFrame">ForwardingProtocolReader</a></li>
@@ -38,7 +37,6 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/serialization/GuardedSerializationTypeAdapter.html" title="class in com.pcloud.networking.serialization" target="classFrame">GuardedSerializationTypeAdapter</a></li>
 <li><a href="com/pcloud/networking/api/Interactor.html" title="interface in com.pcloud.networking.api" target="classFrame"><span class="interfaceName">Interactor</span></a></li>
 <li><a href="com/pcloud/networking/client/Interactor.html" title="interface in com.pcloud.networking.client" target="classFrame"><span class="interfaceName">Interactor</span></a></li>
-<li><a href="com/pcloud/utils/IOUtils.html" title="class in com.pcloud.utils" target="classFrame">IOUtils</a></li>
 <li><a href="com/pcloud/networking/api/Method.html" title="annotation in com.pcloud.networking.api" target="classFrame">Method</a></li>
 <li><a href="com/pcloud/networking/api/MultiCall.html" title="interface in com.pcloud.networking.api" target="classFrame"><span class="interfaceName">MultiCall</span></a></li>
 <li><a href="com/pcloud/networking/client/MultiCall.html" title="interface in com.pcloud.networking.client" target="classFrame"><span class="interfaceName">MultiCall</span></a></li>
@@ -64,19 +62,13 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/client/ResponseBody.html" title="class in com.pcloud.networking.client" target="classFrame">ResponseBody</a></li>
 <li><a href="com/pcloud/networking/client/ResponseData.html" title="class in com.pcloud.networking.client" target="classFrame">ResponseData</a></li>
 <li><a href="com/pcloud/networking/api/ResponseInterceptor.html" title="interface in com.pcloud.networking.api" target="classFrame"><span class="interfaceName">ResponseInterceptor</span></a></li>
-<li><a href="com/pcloud/networking/api/adapters/RxObservableCallAdapter.html" title="class in com.pcloud.networking.api.adapters" target="classFrame">RxObservableCallAdapter</a></li>
-<li><a href="com/pcloud/networking/api/adapters/RxSingleCallAdapter.html" title="class in com.pcloud.networking.api.adapters" target="classFrame">RxSingleCallAdapter</a></li>
 <li><a href="com/pcloud/networking/protocol/SerializationException.html" title="class in com.pcloud.networking.protocol" target="classFrame">SerializationException</a></li>
-<li><a href="com/pcloud/networking/serialization/adapters/TimestampDateTypeAdapter.html" title="class in com.pcloud.networking.serialization.adapters" target="classFrame">TimestampDateTypeAdapter</a></li>
-<li><a href="com/pcloud/networking/serialization/adapters/TimestampDateTypeAdapterFactory.html" title="class in com.pcloud.networking.serialization.adapters" target="classFrame">TimestampDateTypeAdapterFactory</a></li>
 <li><a href="com/pcloud/networking/serialization/Transformer.html" title="class in com.pcloud.networking.serialization" target="classFrame">Transformer</a></li>
 <li><a href="com/pcloud/networking/serialization/Transformer.Builder.html" title="class in com.pcloud.networking.serialization" target="classFrame">Transformer.Builder</a></li>
 <li><a href="com/pcloud/networking/serialization/TypeAdapter.html" title="class in com.pcloud.networking.serialization" target="classFrame">TypeAdapter</a></li>
 <li><a href="com/pcloud/networking/serialization/TypeAdapterFactory.html" title="interface in com.pcloud.networking.serialization" target="classFrame"><span class="interfaceName">TypeAdapterFactory</span></a></li>
-<li><a href="com/pcloud/utils/Types.html" title="class in com.pcloud.utils" target="classFrame">Types</a></li>
 <li><a href="com/pcloud/networking/protocol/TypeToken.html" title="enum in com.pcloud.networking.protocol" target="classFrame">TypeToken</a></li>
 <li><a href="com/pcloud/networking/serialization/UnserializableTypeException.html" title="class in com.pcloud.networking.serialization" target="classFrame">UnserializableTypeException</a></li>
-<li><a href="com/pcloud/networking/client/internal/Utils.html" title="class in com.pcloud.networking.client.internal" target="classFrame">Utils</a></li>
 <li><a href="com/pcloud/networking/protocol/ValueReader.html" title="class in com.pcloud.networking.protocol" target="classFrame">ValueReader</a></li>
 <li><a href="com/pcloud/networking/protocol/ValueWriter.html" title="class in com.pcloud.networking.protocol" target="classFrame">ValueWriter</a></li>
 </ul>

docs/allclasses-noframe.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_91) on Fri Mar 23 19:14:27 EET 2018 -->
+    <!-- Generated by javadoc (1.8.0_91) on Wed Oct 23 16:41:34 EEST 2019 -->
 <title>All Classes</title>
-<meta name="date" content="2018-03-23">
+    <meta name="date" content="2019-10-23">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -28,7 +28,6 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/api/DataApiResponse.html" title="class in com.pcloud.networking.api">DataApiResponse</a></li>
 <li><a href="com/pcloud/networking/protocol/DataSink.html" title="class in com.pcloud.networking.protocol">DataSink</a></li>
 <li><a href="com/pcloud/networking/protocol/DataSource.html" title="class in com.pcloud.networking.protocol">DataSource</a></li>
-<li><a href="com/pcloud/networking/client/internal/tls/DefaultHostnameVerifier.html" title="class in com.pcloud.networking.client.internal.tls">DefaultHostnameVerifier</a></li>
 <li><a href="com/pcloud/networking/client/Endpoint.html" title="class in com.pcloud.networking.client">Endpoint</a></li>
 <li><a href="com/pcloud/networking/client/EndpointProvider.html" title="interface in com.pcloud.networking.client"><span class="interfaceName">EndpointProvider</span></a></li>
 <li><a href="com/pcloud/networking/protocol/ForwardingProtocolReader.html" title="class in com.pcloud.networking.protocol">ForwardingProtocolReader</a></li>
@@ -38,7 +37,6 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/serialization/GuardedSerializationTypeAdapter.html" title="class in com.pcloud.networking.serialization">GuardedSerializationTypeAdapter</a></li>
 <li><a href="com/pcloud/networking/api/Interactor.html" title="interface in com.pcloud.networking.api"><span class="interfaceName">Interactor</span></a></li>
 <li><a href="com/pcloud/networking/client/Interactor.html" title="interface in com.pcloud.networking.client"><span class="interfaceName">Interactor</span></a></li>
-<li><a href="com/pcloud/utils/IOUtils.html" title="class in com.pcloud.utils">IOUtils</a></li>
 <li><a href="com/pcloud/networking/api/Method.html" title="annotation in com.pcloud.networking.api">Method</a></li>
 <li><a href="com/pcloud/networking/api/MultiCall.html" title="interface in com.pcloud.networking.api"><span class="interfaceName">MultiCall</span></a></li>
 <li><a href="com/pcloud/networking/client/MultiCall.html" title="interface in com.pcloud.networking.client"><span class="interfaceName">MultiCall</span></a></li>
@@ -64,19 +62,13 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/pcloud/networking/client/ResponseBody.html" title="class in com.pcloud.networking.client">ResponseBody</a></li>
 <li><a href="com/pcloud/networking/client/ResponseData.html" title="class in com.pcloud.networking.client">ResponseData</a></li>
 <li><a href="com/pcloud/networking/api/ResponseInterceptor.html" title="interface in com.pcloud.networking.api"><span class="interfaceName">ResponseInterceptor</span></a></li>
-<li><a href="com/pcloud/networking/api/adapters/RxObservableCallAdapter.html" title="class in com.pcloud.networking.api.adapters">RxObservableCallAdapter</a></li>
-<li><a href="com/pcloud/networking/api/adapters/RxSingleCallAdapter.html" title="class in com.pcloud.networking.api.adapters">RxSingleCallAdapter</a></li>
 <li><a href="com/pcloud/networking/protocol/SerializationException.html" title="class in com.pcloud.networking.protocol">SerializationException</a></li>
-<li><a href="com/pcloud/networking/serialization/adapters/TimestampDateTypeAdapter.html" title="class in com.pcloud.networking.serialization.adapters">TimestampDateTypeAdapter</a></li>
-<li><a href="com/pcloud/networking/serialization/adapters/TimestampDateTypeAdapterFactory.html" title="class in com.pcloud.networking.serialization.adapters">TimestampDateTypeAdapterFactory</a></li>
 <li><a href="com/pcloud/networking/serialization/Transformer.html" title="class in com.pcloud.networking.serialization">Transformer</a></li>
 <li><a href="com/pcloud/networking/serialization/Transformer.Builder.html" title="class in com.pcloud.networking.serialization">Transformer.Builder</a></li>
 <li><a href="com/pcloud/networking/serialization/TypeAdapter.html" title="class in com.pcloud.networking.serialization">TypeAdapter</a></li>
 <li><a href="com/pcloud/networking/serialization/TypeAdapterFactory.html" title="interface in com.pcloud.networking.serialization"><span class="interfaceName">TypeAdapterFactory</span></a></li>
-<li><a href="com/pcloud/utils/Types.html" title="class in com.pcloud.utils">Types</a></li>
 <li><a href="com/pcloud/networking/protocol/TypeToken.html" title="enum in com.pcloud.networking.protocol">TypeToken</a></li>
 <li><a href="com/pcloud/networking/serialization/UnserializableTypeException.html" title="class in com.pcloud.networking.serialization">UnserializableTypeException</a></li>
-<li><a href="com/pcloud/networking/client/internal/Utils.html" title="class in com.pcloud.networking.client.internal">Utils</a></li>
 <li><a href="com/pcloud/networking/protocol/ValueReader.html" title="class in com.pcloud.networking.protocol">ValueReader</a></li>
 <li><a href="com/pcloud/networking/protocol/ValueWriter.html" title="class in com.pcloud.networking.protocol">ValueWriter</a></li>
 </ul>

docs/com/pcloud/networking/api/ApiComposer.Builder.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_91) on Fri Mar 23 19:14:25 EET 2018 -->
+ <!-- Generated by javadoc (1.8.0_91) on Wed Oct 23 16:41:34 EEST 2019 -->
 <title>ApiComposer.Builder</title>
-<meta name="date" content="2018-03-23">
+ <meta name="date" content="2019-10-23">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>

docs/com/pcloud/networking/api/ApiComposer.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_91) on Fri Mar 23 19:14:25 EET 2018 -->
+    <!-- Generated by javadoc (1.8.0_91) on Wed Oct 23 16:41:34 EEST 2019 -->
 <title>ApiComposer</title>
-<meta name="date" content="2018-03-23">
+    <meta name="date" content="2019-10-23">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>

docs/com/pcloud/networking/api/ApiResponse.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_91) on Fri Mar 23 19:14:25 EET 2018 -->
+    <!-- Generated by javadoc (1.8.0_91) on Wed Oct 23 16:41:34 EEST 2019 -->
 <title>ApiResponse</title>
-<meta name="date" content="2018-03-23">
+    <meta name="date" content="2019-10-23">
 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
 <script type="text/javascript" src="../../../../script.js"></script>
 </head>
@@ -196,7 +196,10 @@ <h3>Method Summary</h3>
 </tr>
 <tr id="i3" class="rowColor">
 <td class="colFirst"><code>java.lang.String</code></td>
-<td class="colLast"><code><span class="memberNameLink"><a href="../../../../com/pcloud/networking/api/ApiResponse.html#toString--">toString</a></span>()</code>&nbsp;</td>
+    <td class="colLast"><code><span class="memberNameLink"><a
+            href="../../../../com/pcloud/networking/api/ApiResponse.html#toString--">toString</a></span>()</code>
+        <div class="block">Returns a string representation of the object.</div>
+    </td>
 </tr>
 </table>
 <ul class="blockList">
@@ -315,9 +318,32 @@ <h4>isSuccessful</h4>
 <li class="blockList">
 <h4>toString</h4>
 <pre>public&nbsp;java.lang.String&nbsp;toString()</pre>
+    <div class="block"><span class="descfrmTypeLabel">Description copied from class:&nbsp;<code>java.lang.Object</code></span>
+    </div>
+    <div class="block">Returns a string representation of the object. In general, the
+        <code>toString</code> method returns a string that
+        "textually represents" this object. The result should
+        be a concise but informative representation that is easy for a
+        person to read.
+        It is recommended that all subclasses override this method.
+        <p>
+            The <code>toString</code> method for class <code>Object</code>
+            returns a string consisting of the name of the class of which the
+            object is an instance, the at-sign character `<code>@</code>', and
+            the unsigned hexadecimal representation of the hash code of the
+            object. In other words, this method returns a string equal to the
+            value of:
+        <blockquote>
+ <pre>
+ getClass().getName() + '@' + Integer.toHexString(hashCode())
+ </pre>
+        </blockquote>
+    </div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
 <dd><code>toString</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
+    <dt><span class="returnLabel">Returns:</span></dt>
+    <dd>a string representation of the object.</dd>
 </dl>
 </li>
 </ul>