implement AppAuthClient for default HTTP clients

Author: wfraser

README.md

@@ -69,9 +69,8 @@ The authentication type is designated by implementing a marker trait in
 addition to the base `HttpClient` trait: one of `NoauthClient`,
 `UserAuthClient`, `TeamAuthClient`, or `AppAuthClient`.
 
-The default client has implementations of all of these (except for
-`AppAuthClient` currently). They all share a common implementation and differ
-only in which HTTP headers they add to the request.
+The default client has implementations of all of these. They all share a common
+implementation and differ only in which HTTP headers they add to the request.
 
 [authentication types]: https://www.dropbox.com/developers/reference/auth-types
 

RELEASE_NOTES.md

@@ -1,3 +1,7 @@
+# v0.19.0-beta3
+xxxx-yy-zz
+* added implementations of AppAuthClient to default HTTP clients
+
 # v0.19.0-beta2
 2024-11-05
 * renamed sync_routes_default feature to sync_routes_in_root

src/default_async_client.rs

@@ -15,7 +15,7 @@ use std::str::FromStr;
 use std::sync::Arc;
 use bytes::Bytes;
 use futures::{FutureExt, TryFutureExt, TryStreamExt};
-use crate::async_client_trait::{HttpClient, HttpRequestResultRaw, NoauthClient, TeamAuthClient, UserAuthClient};
+use crate::async_client_trait::{AppAuthClient, HttpClient, HttpRequestResultRaw, NoauthClient, TeamAuthClient, UserAuthClient};
 use crate::client_trait_common::{HttpRequest, TeamSelect};
 use crate::default_client_common::impl_set_path_root;
 use crate::Error;
@@ -156,6 +156,44 @@ impl HttpClient for TeamAuthDefaultClient {
 
 impl TeamAuthClient for TeamAuthDefaultClient {}
 
+/// Default HTTP client using App authorization.
+#[derive(Debug)]
+pub struct AppAuthDefaultClient {
+    inner: ReqwestClient,
+    path_root: Option<String>,
+    auth: String,
+}
+
+impl AppAuthDefaultClient {
+    /// Create a new App auth client using the given app key and secret, which can be found in the Dropbox app console.
+    pub fn new(app_key: &str, app_secret: &str) -> Self {
+        use base64::prelude::*;
+        let encoded = BASE64_STANDARD.encode(format!("{app_key}:{app_secret}"));
+        Self {
+            inner: ReqwestClient::default(),
+            path_root: None,
+            auth: format!("Basic {encoded}"),
+        }
+    }
+
+    impl_set_path_root!(self);
+}
+
+impl HttpClient for AppAuthDefaultClient {
+    type Request = ReqwestRequest;
+
+    fn execute(&self, request: Self::Request, body: Bytes) -> impl Future<Output=Result<HttpRequestResultRaw, Error>> + Send {
+        self.inner.execute(request, body)
+    }
+
+    fn new_request(&self, url: &str) -> Self::Request {
+        self.inner.new_request(url)
+            .set_header("Authorization", &self.auth)
+    }
+}
+
+impl AppAuthClient for AppAuthDefaultClient {}
+
 /// Default HTTP client for unauthenticated API calls.
 #[derive(Debug, Default)]
 pub struct NoauthDefaultClient {

src/default_client.rs

@@ -18,7 +18,7 @@ use std::fmt::Write;
 use std::str::FromStr;
 use std::sync::Arc;
 use futures::FutureExt;
-use crate::client_trait::{HttpClient, HttpRequestResultRaw, NoauthClient, TeamAuthClient, UserAuthClient};
+use crate::client_trait::{AppAuthClient, HttpClient, HttpRequestResultRaw, NoauthClient, TeamAuthClient, UserAuthClient};
 use crate::client_trait_common::{HttpRequest, TeamSelect};
 use crate::default_client_common::impl_set_path_root;
 
@@ -145,6 +145,44 @@ impl HttpClient for TeamAuthDefaultClient {
 
 impl TeamAuthClient for TeamAuthDefaultClient {}
 
+/// Default HTTP client using App authorization.
+#[derive(Debug)]
+pub struct AppAuthDefaultClient {
+    inner: UreqClient,
+    path_root: Option<String>,
+    auth: String,
+}
+
+impl AppAuthDefaultClient {
+    /// Create a new App auth client using the given app key and secret, which can be found in the Dropbox app console.
+    pub fn new(app_key: &str, app_secret: &str) -> Self {
+        use base64::prelude::*;
+        let encoded = BASE64_STANDARD.encode(format!("{app_key}:{app_secret}"));
+        Self {
+            inner: UreqClient::default(),
+            path_root: None,
+            auth: format!("Basic {encoded}"),
+        }
+    }
+
+    impl_set_path_root!(self);
+}
+
+impl HttpClient for AppAuthDefaultClient {
+    type Request = UreqRequest;
+
+    fn execute(&self, request: Self::Request, body: &[u8]) -> Result<HttpRequestResultRaw, Error> {
+        self.inner.execute(request, body)
+    }
+
+    fn new_request(&self, url: &str) -> Self::Request {
+        self.inner.new_request(url)
+            .set_header("Authorization", &self.auth)
+    }
+}
+
+impl AppAuthClient for AppAuthDefaultClient {}
+
 /// Default HTTP client for unauthenticated API calls.
 #[derive(Debug, Default)]
 pub struct NoauthDefaultClient {