Rename misleading serde feature to iter-ext

The `serde` feature flag was misleading: the serde crate is an
unconditional dependency, and the feature only gated the `iter_ext`
module (par_map/try_par_map). Rename it to `iter-ext` to accurately
reflect what it controls.

Also fix inaccurate doc comments on run_bytes/try_run_bytes that
referenced the non-existent serde feature gate.

Author: paberr

.github/workflows/test.yml

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        features: ["--all-features", "--no-default-features --features serde,codec-pot"]
+        features: ["--all-features", "--no-default-features --features iter-ext,codec-pot"]
 
     steps:
       - uses: actions/checkout@v4
@@ -31,7 +31,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        features: ["--all-features", "--no-default-features --features serde,macros,codec-pot"]
+        features: ["--all-features", "--no-default-features --features iter-ext,macros,codec-pot"]
 
     steps:
       - uses: actions/checkout@v4

Cargo.toml

@@ -11,7 +11,7 @@ readme = "README.md"
 keywords = ["webworker", "parallelism", "wasm"]
 
 [workspace.dependencies]
-wasmworker = { version = "0.3", path = ".", features = ["serde", "macros"] }
+wasmworker = { version = "0.3", path = ".", features = ["iter-ext", "macros"] }
 wasmworker-proc-macro = { version = "0.3", path = "proc-macro" }
 
 [package]
@@ -64,8 +64,8 @@ version = "0.3"
 wasmworker-proc-macro = { workspace = true }
 
 [features]
-default = ["serde", "codec-postcard"]
-serde = []
+default = ["iter-ext", "codec-postcard"]
+iter-ext = []
 codec-postcard = ["dep:postcard"]
 codec-pot = ["dep:pot"]
 macros = ["wasmworker-proc-macro"]

README.md

@@ -32,12 +32,10 @@ Enable the `macros` feature to get access to the `#[webworker_fn]` and `#[webwor
 wasmworker = { version = "0.3", features = ["macros"] }
 ```
 
-The `wasmworker` crate comes with a default feature called `serde`, which allows running any function on a web worker under the following two conditions:
-1. The function takes a single argument, which implements `serde::Serialize + serde::Deserialize<'de>`.
-2. The return type implements `serde::Serialize + serde::Deserialize<'de>`.
+Function arguments and return types must implement `serde::Serialize + serde::Deserialize<'de>`.
+Alternatively, functions with the type `fn(Box<[u8]>) -> Box<[u8]>` can be used via `run_bytes()` for manual serialization.
 
-Without the `serde` feature, only functions with the type `fn(Box<[u8]>) -> Box<[u8]>` can be run on a worker.
-This is useful for users that do not want a direct serde dependency. Internally, the library always uses serde, though.
+The `iter-ext` feature (enabled by default) adds the `par_map` and `try_par_map` iterator extensions for convenient parallel map operations on the default worker pool.
 
 #### Serialization codec
 By default, `wasmworker` uses [postcard](https://crates.io/crates/postcard) for internal serialization.
@@ -48,7 +46,7 @@ Note that pot has significantly higher serialization overhead and larger output
 
 ```toml
 [dependencies]
-wasmworker = { version = "0.3", default-features = false, features = ["serde", "macros", "codec-pot"] }
+wasmworker = { version = "0.3", default-features = false, features = ["iter-ext", "macros", "codec-pot"] }
 ```
 
 You can then start using the library without further setup.

src/func.rs

@@ -13,6 +13,7 @@ pub struct WebWorkerFn<T, R> {
     /// The worker will automatically add the `__webworker_` prefix.
     pub(crate) name: &'static str,
     /// The original function, which can be used as a fallback.
+    #[cfg_attr(not(feature = "iter-ext"), allow(dead_code))]
     pub(crate) func: fn(T) -> R,
 }
 

src/lib.rs

@@ -118,7 +118,7 @@ pub mod convert;
 pub mod error;
 pub mod func;
 mod global;
-#[cfg(feature = "serde")]
+#[cfg(feature = "iter-ext")]
 pub mod iter_ext;
 pub mod pool;
 mod webworker;

src/pool/mod.rs

@@ -318,7 +318,7 @@ impl WebWorkerPool {
 
     /// This function can outsource a task on a [`WebWorkerPool`] which has `Box<[u8]>` both as input and output.
     /// (De)serialization of values needs to be handled by the caller.
-    /// For more convenient access, make sure the `serde` feature is enabled and use [`WebWorkerPool::run`].
+    /// For more convenient access, use [`WebWorkerPool::run`] instead.
     ///
     /// The `func`: [`WebWorkerFn`] argument should normally be instantiated using the [`crate::webworker!`] macro.
     /// This ensures type safety and that the function is correctly exposed to the worker.

src/webworker/worker.rs

@@ -295,7 +295,7 @@ impl WebWorker {
 
     /// This function can outsource a task on a [`WebWorker`] which has `Box<[u8]>` both as input and output.
     /// (De)serialization of values needs to be handled by the caller.
-    /// For more convenient access, make sure the `serde` feature is enabled and use [`WebWorker::run`].
+    /// For more convenient access, use [`WebWorker::run`] instead.
     ///
     /// The `func`: [`WebWorkerFn`] argument should normally be instantiated using the [`crate::webworker!`] macro.
     /// This ensures type safety and that the function is correctly exposed to the worker.
@@ -318,7 +318,7 @@ impl WebWorker {
     /// This function differs from [`WebWorker::run_bytes`] by returning early if the given task limit is reached.
     /// In this case a [`Full`] error is returned.
     /// (De)serialization of values needs to be handled by the caller.
-    /// For more convenient access, make sure the `serde` feature is enabled and use [`WebWorker::try_run`].
+    /// For more convenient access, use [`WebWorker::try_run`] instead.
     ///
     /// The `func`: [`WebWorkerFn`] argument should normally be instantiated using the [`crate::webworker!`] macro.
     /// This ensures type safety and that the function is correctly exposed to the worker.