Merge #89: Misc ergonomic improvements; release 0.14.1

184740e bump version to 0.14.1 (Andrew Poelstra)
1dc1528 simple_http: add support for replacing URL and path (Andrew Poelstra)
d673b83 docs: document things correctly with feature gates (Andrew Poelstra)
c25cdb7 Implement Client::from for Transports (Andrew Poelstra)

Pull request description:

  Adds a couple utility functions and releases 0.14.1.

ACKs for top commit:
  sanket1729:
    utACK 184740e

Tree-SHA512: 9b3c3d2d275c8243df9a3bb26790314c461479fdb04d6948c1689619162956117b52909abec59b87ff103976d0e3bf774450533765413d2cba5b6d811350a207

Author: apoelstra

CHANGELOG.md

@@ -1,3 +1,13 @@
+# 0.14.1 - 2023-04-03
+
+* simple_http: fix "re-open socket on write failure" behavior
+  [#84](https://github.com/apoelstra/rust-jsonrpc/pull/84)
+  [#86](https://github.com/apoelstra/rust-jsonrpc/pull/86)
+* simple_http: add "host" header (required by HTTP 1.1)
+  [#85](https://github.com/apoelstra/rust-jsonrpc/pull/85)
+* simple_http: add ability to replace URL/path; minor ergonomic improvements
+  [#89](https://github.com/apoelstra/rust-jsonrpc/pull/89)
+
 # 0.14.0 - 2022-11-28
 
 This release significantly improves our `simple_http` client, though at the

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jsonrpc"
-version = "0.14.0"
+version = "0.14.1"
 authors = ["Andrew Poelstra <[email protected]>"]
 license = "CC0-1.0"
 homepage = "https://github.com/apoelstra/rust-jsonrpc/"
@@ -11,6 +11,10 @@ keywords = [ "protocol", "json", "http", "jsonrpc" ]
 readme	 = "README.md"
 edition = "2018"
 
+[package.metadata.docs.rs]
+all-features = true
+rustdoc-args = ["--cfg", "docsrs"]
+
 [lib]
 name = "jsonrpc"
 path = "src/lib.rs"

src/client.rs

@@ -155,6 +155,12 @@ impl fmt::Debug for crate::Client {
     }
 }
 
+impl<T: Transport> From<T> for Client {
+    fn from(t: T) -> Client {
+        Client::with_transport(t)
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;

src/lib.rs

@@ -17,11 +17,9 @@
 //! Rust support for the JSON-RPC 2.0 protocol.
 //!
 
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
+
 // Coding conventions
-#![deny(non_upper_case_globals)]
-#![deny(non_camel_case_types)]
-#![deny(non_snake_case)]
-#![deny(unused_mut)]
 #![warn(missing_docs)]
 
 use serde::{Deserialize, Serialize};

src/simple_http.rs

@@ -119,6 +119,19 @@ impl SimpleHttpTransport {
         Builder::new()
     }
 
+    /// Replaces the URL of the transport
+    pub fn set_url(&mut self, url: &str) -> Result<(), Error> {
+        let url = check_url(url)?;
+        self.addr = url.0;
+        self.path = url.1;
+        Ok(())
+    }
+
+    /// Replaces only the path part of the URL
+    pub fn set_url_path(&mut self, path: String) {
+        self.path = path;
+    }
+
     fn request<R>(&self, req: impl serde::Serialize) -> Result<R, Error>
     where
         R: for<'a> serde::de::Deserialize<'a>,
@@ -533,9 +546,7 @@ impl Builder {
 
     /// Sets the URL of the server to the transport.
     pub fn url(mut self, url: &str) -> Result<Self, Error> {
-        let url = check_url(url)?;
-        self.tp.addr = url.0;
-        self.tp.path = url.1;
+        self.tp.set_url(url)?;
         Ok(self)
     }