Add flashing feature, disable feature-specific dependencies

Author: bugadani

.github/workflows/ci.yml

@@ -74,7 +74,6 @@ jobs:
     runs-on: ubuntu-22.04
 
     steps:
-
       - uses: actions/checkout@v4
 
       - uses: ./.github/actions/setup-target
@@ -83,6 +82,8 @@ jobs:
           target: ${{ matrix.platform.target }}
 
       - run: cargo check -p espflash --lib --no-default-features
+      - run: cargo check -p espflash --lib --no-default-features --features flashing
+      - run: cargo check -p espflash --lib --no-default-features --features serialport
 
   msrv:
     name: Check MSRV (${{ matrix.platform.target }})

espflash/Cargo.toml

@@ -50,12 +50,12 @@ regex = { version = "1.10.3", optional = true }
 serde = { version = "1.0.196", features = ["derive"] }
 serialport = { version = "4.3.0", optional = true }
 sha2 = "0.10.8"
-slip-codec = "0.4.0"
+slip-codec = { version = "0.4.0", optional = true }
 strum = { version = "0.26.1", features = ["derive"] }
 thiserror = "1.0.56"
 toml = "0.8.10"
 update-informer = { version = "1.1.0", optional = true }
-xmas-elf        = "0.9.1"
+xmas-elf        = { version = "0.9.1", optional = true }
 
 [target.'cfg(unix)'.dependencies]
 libc = "0.2.153"
@@ -78,8 +78,12 @@ cli = [
     "dep:indicatif",
     "dep:lazy_static",
     "dep:parse_int",
-    "dep:regex",
     "dep:update-informer",
-    "serialport",
+    "serialport"
 ]
-serialport = ["dep:serialport"]
+
+# enables connecting to a device via serial port
+serialport = ["flashing", "dep:serialport", "dep:slip-codec", "dep:regex"]
+
+# enables flash stubs and stub commands
+flashing = ["xmas-elf"]

espflash/src/command.rs

@@ -1,4 +1,4 @@
-//! Send commands to a target device
+//! Commands to work with a flasher stub running on a target device
 
 use std::{io::Write, mem::size_of, time::Duration};
 

espflash/src/error.rs

@@ -6,6 +6,7 @@ use std::{
 };
 
 use miette::Diagnostic;
+#[cfg(feature = "serialport")]
 use slip_codec::SlipError;
 use strum::{FromRepr, VariantNames};
 use thiserror::Error;

espflash/src/lib.rs

@@ -31,12 +31,14 @@
 #[cfg(feature = "cli")]
 #[cfg_attr(docsrs, doc(cfg(feature = "cli")))]
 pub mod cli;
+#[cfg(feature = "flashing")]
 pub mod command;
 #[cfg(feature = "serialport")]
 #[cfg_attr(docsrs, doc(cfg(feature = "serialport")))]
 pub mod connection;
 pub mod elf;
 pub mod error;
+#[cfg(feature = "flashing")]
 pub mod flasher;
 pub mod image_format;
 pub mod targets;