feat: Login is not mandatory, with QBittorrentClient::new_not_logged_in

Author: angrynode

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- `QBittorrentClient` methods `new_not_logged_in` and `do_login` enable building a client
+  without actually performing a login
 - `QBittorrentClient::qbittorrent_version` returns the qbittorrent daemon version
 
 ## Version 0.2.1 (2025-08-28)

src/api_error.rs

@@ -22,4 +22,8 @@ pub enum ApiError {
     },
     #[snafu(display("Invalid infohash: {source}"))]
     InfoHash { source: hightorrent::InfoHashError },
+    #[snafu(display("Failed to initialize the torrent API client:\n{source}"))]
+    ClientInit {
+        source: Box<dyn std::error::Error + 'static + Send + Sync>,
+    },
 }

src/qbittorrent/api.rs

@@ -26,6 +26,48 @@ pub struct QBittorrentClient {
 }
 
 impl QBittorrentClient {
+    /// Create a new client that's not logged in yet.
+    ///
+    /// Then perform `QBittorrentClient::do_login` to actually login.
+    pub fn new_not_logged_in(host: &str, user: &str, password: &str) -> Result<Self, Error> {
+        let client = ClientBuilder::new()
+            .cookie_store(true)
+            .build()
+            .boxed()
+            .context(ClientInitError)?;
+
+        Ok(Self {
+            host: host.to_string(),
+            user: user.to_string(),
+            password: password.to_string(),
+            client,
+        })
+    }
+
+    pub async fn do_login(&self) -> Result<(), Error> {
+        let form = Form::new()
+            .text("username", self.user.to_string())
+            .text("password", self.password.to_string());
+
+        let res = self
+            .client
+            .post(format!("{}/api/v2/auth/login", self.host))
+            .multipart(form)
+            .send()
+            .await
+            .boxed()
+            .context(HttpError)?;
+
+        if res.headers().get("set-cookie").is_some() {
+            Ok(())
+        } else {
+            Err(Error::InvalidLogin {
+                host: self.host.to_string(),
+                user: self.user.to_string(),
+            })
+        }
+    }
+
     /// Returns the qBittorrent version, in a `vX.Y.Z` format.
     pub async fn qbittorrent_version(&self) -> Result<String, Error> {
         let res = self._get(self._endpoint("app/version")).await?;
@@ -205,37 +247,9 @@ impl Api for QBittorrentClient {
     }
 
     async fn login(host: &str, user: &str, password: &str) -> Result<Self, Error> {
-        let client = ClientBuilder::new()
-            .cookie_store(true)
-            .build()
-            .boxed()
-            .context(HttpError)?;
-
-        let form = Form::new()
-            .text("username", user.to_string())
-            .text("password", password.to_string());
-
-        let res = client
-            .post(format!("{}/api/v2/auth/login", host))
-            .multipart(form)
-            .send()
-            .await
-            .boxed()
-            .context(HttpError)?;
-
-        if res.headers().get("set-cookie").is_some() {
-            Ok(Self {
-                host: host.to_string(),
-                user: user.to_string(),
-                password: password.to_string(),
-                client,
-            })
-        } else {
-            Err(Error::InvalidLogin {
-                host: host.to_string(),
-                user: user.to_string(),
-            })
-        }
+        let api_client = Self::new_not_logged_in(host, user, password)?;
+        api_client.do_login().await?;
+        Ok(api_client)
     }
 
     async fn list(&self) -> Result<TorrentList, Error> {