feat: add --target-tag for version targeting and downgrade

QaidVoid · QaidVoid · commit 513e522aefab · 2026-04-14T10:00:06.000+05:45
Override the release tag from the embedded update info to install
a specific version. Works with all forge-based update info types.
diff --git a/src/main.rs b/src/main.rs
@@ -37,6 +37,9 @@ struct Cli {
     #[arg(short = 'j', long)]
     check_for_update: bool,
 
+    #[arg(short = 't', long, value_name = "TAG")]
+    target_tag: Option<String>,
+
     #[arg(
         long,
         value_name = "URL",
@@ -305,10 +308,16 @@ fn is_appimage(path: &Path) -> bool {
 }
 
 fn create_updater(cli: &Cli, path: &Path) -> Result<Updater, Error> {
-    if let Some(ref info) = cli.update_info {
-        Updater::with_update_info(path, info)
+    let updater = if let Some(ref info) = cli.update_info {
+        Updater::with_update_info(path, info)?
+    } else {
+        Updater::new(path)?
+    };
+
+    if let Some(ref tag) = cli.target_tag {
+        updater.target_tag(tag)
     } else {
-        Updater::new(path)
+        Ok(updater)
     }
 }
 
diff --git a/src/update_info/forge.rs b/src/update_info/forge.rs
@@ -43,6 +43,11 @@ impl ForgeUpdateInfo {
         }
     }
 
+    pub fn set_tag(&mut self, tag: String) {
+        self.tag = tag;
+        self.resolved_url = OnceCell::new();
+    }
+
     pub fn zsync_url(&self) -> Result<&str> {
         if self.resolved_url.get().is_none() {
             let url = self.resolve_url()?;
diff --git a/src/update_info/mod.rs b/src/update_info/mod.rs
@@ -32,6 +32,17 @@ impl UpdateInfo {
         &self.raw
     }
 
+    pub fn with_target_tag(mut self, tag: &str) -> Self {
+        if let UpdateInfoInner::Forge(ref mut f) = self.inner {
+            f.set_tag(tag.to_owned());
+        }
+        self
+    }
+
+    pub fn is_forge(&self) -> bool {
+        matches!(self.inner, UpdateInfoInner::Forge(_))
+    }
+
     pub fn zsync_url(&self) -> Result<String> {
         match &self.inner {
             UpdateInfoInner::Generic(g) => Ok(g.zsync_url().to_owned()),
diff --git a/src/updater.rs b/src/updater.rs
@@ -96,6 +96,16 @@ impl Updater {
         self
     }
 
+    pub fn target_tag(mut self, tag: &str) -> Result<Self> {
+        if !self.update_info.is_forge() {
+            return Err(Error::InvalidUpdateInfo(
+                "--target-tag is only supported for forge-based update info".into(),
+            ));
+        }
+        self.update_info = self.update_info.with_target_tag(tag);
+        Ok(self)
+    }
+
     pub fn progress_callback<F>(mut self, callback: F) -> Self
     where
         F: Fn(u64, u64) + Send + Sync + 'static,

Original file line number	Diff line number	Diff line change
`@@ -43,6 +43,11 @@ impl ForgeUpdateInfo {`
`43`	`43`	`}`
`44`	`44`	`}`
`45`	`45`
	`46`	`+ pub fn set_tag(&mut self, tag: String) {`
	`47`	`+ self.tag = tag;`
	`48`	`+ self.resolved_url = OnceCell::new();`
	`49`	`+ }`
	`50`	`+`
`46`	`51`	`pub fn zsync_url(&self) -> Result<&str> {`
`47`	`52`	`if self.resolved_url.get().is_none() {`
`48`	`53`	`let url = self.resolve_url()?;`