feat(crate): init soar-package crate (#120)

Author: QaidVoid

Cargo.lock

@@ -4,6 +4,7 @@ members = [
   "crates/soar-config",
   "crates/soar-db",
   "crates/soar-dl",
+  "crates/soar-package",
   "crates/soar-registry",
   "crates/soar-utils",
   "soar-cli",
@@ -44,6 +45,7 @@ serial_test = "3.2.0"
 soar-config = { path = "crates/soar-config" }
 soar-core = { path = "soar-core" }
 soar-dl = { path = "crates/soar-dl" }
+soar-package = { path = "crates/soar-package" }
 soar-registry = { path = "crates/soar-registry" }
 soar-utils = { path = "crates/soar-utils" }
 tempfile = "3.10.1"

Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "soar-package"
+version = "0.1.0"
+description = "Package format handling for soar package manager"
+authors.workspace = true
+edition.workspace = true
+readme.workspace = true
+repository.workspace = true
+license.workspace = true
+keywords.workspace = true
+categories.workspace = true
+
+[dependencies]
+image = { version = "0.25.8", default-features = false, features = ["png"] }
+miette = { workspace = true }
+regex = { workspace = true }
+soar-config = { workspace = true }
+soar-utils = { workspace = true }
+squishy = { version = "0.3.2", features = ["appimage"] }
+thiserror = { workspace = true }

crates/soar-package/Cargo.toml

@@ -0,0 +1,76 @@
+//! Error types for the package crate.
+
+use miette::Diagnostic;
+use thiserror::Error;
+
+/// Errors that can occur during package operations.
+#[derive(Error, Diagnostic, Debug)]
+pub enum PackageError {
+    #[error("IO error while {action}: {source}")]
+    #[diagnostic(code(soar_package::io))]
+    IoError {
+        action: String,
+        source: std::io::Error,
+    },
+
+    #[error("Failed to read magic bytes")]
+    #[diagnostic(code(soar_package::magic_bytes))]
+    MagicBytesError,
+
+    #[error("Failed to seek in file")]
+    #[diagnostic(code(soar_package::seek))]
+    SeekError,
+
+    #[error("Image processing error: {0}")]
+    #[diagnostic(code(soar_package::image))]
+    ImageError(#[from] image::ImageError),
+
+    #[error("AppImage error: {0}")]
+    #[diagnostic(code(soar_package::appimage))]
+    AppImageError(#[from] squishy::error::SquishyError),
+
+    #[error("Configuration error: {0}")]
+    #[diagnostic(code(soar_package::config))]
+    ConfigError(String),
+
+    #[error("{0}")]
+    #[diagnostic(code(soar_package::custom))]
+    Custom(String),
+}
+
+/// A specialized Result type for package operations.
+pub type Result<T> = std::result::Result<T, PackageError>;
+
+/// Extension trait for adding context to I/O errors.
+pub trait ErrorContext<T> {
+    /// Adds context to an error, describing what action was being performed.
+    fn with_context<C>(self, context: C) -> Result<T>
+    where
+        C: FnOnce() -> String;
+}
+
+impl<T> ErrorContext<T> for std::io::Result<T> {
+    fn with_context<C>(self, context: C) -> Result<T>
+    where
+        C: FnOnce() -> String,
+    {
+        self.map_err(|err| {
+            PackageError::IoError {
+                action: context(),
+                source: err,
+            }
+        })
+    }
+}
+
+impl From<soar_config::error::ConfigError> for PackageError {
+    fn from(err: soar_config::error::ConfigError) -> Self {
+        PackageError::ConfigError(err.to_string())
+    }
+}
+
+impl From<soar_utils::error::FileSystemError> for PackageError {
+    fn from(err: soar_utils::error::FileSystemError) -> Self {
+        PackageError::Custom(err.to_string())
+    }
+}

crates/soar-package/src/error.rs

@@ -1,20 +1,42 @@
+//! AppImage format handling.
+
 use std::{fs, path::Path};
 
 use soar_utils::fs::read_file_signature;
 use squishy::{appimage::AppImage, EntryKind};
 
-use super::common::{symlink_desktop, symlink_icon};
+use super::{
+    common::{symlink_desktop, symlink_icon},
+    PNG_MAGIC_BYTES,
+};
 use crate::{
-    constants::PNG_MAGIC_BYTES, database::models::PackageExt, error::ErrorContext, SoarResult,
+    error::{ErrorContext, Result},
+    traits::PackageExt,
 };
 
+/// Integrates an AppImage by extracting its embedded resources.
+///
+/// This function extracts icons, desktop files, and AppStream metadata from
+/// an AppImage and sets up the appropriate symlinks for desktop integration.
+///
+/// # Arguments
+///
+/// * `install_dir` - Directory where the package is installed
+/// * `file_path` - Path to the AppImage file
+/// * `package` - Package metadata
+/// * `has_icon` - Whether an icon was already found in the install directory
+/// * `has_desktop` - Whether a desktop file was already found
+///
+/// # Errors
+///
+/// Returns [`PackageError`] if extraction or symlink creation fails.
 pub async fn integrate_appimage<P: AsRef<Path>, T: PackageExt>(
     install_dir: P,
     file_path: P,
     package: &T,
     has_icon: bool,
     has_desktop: bool,
-) -> SoarResult<()> {
+) -> Result<()> {
     if has_icon && has_desktop {
         return Ok(());
     }