Add append and append_into functions

Author: sunsided

CHANGELOG.md

@@ -3,17 +3,24 @@
 All notable changes to this project will be documented in this file.
 This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2023-07-08
+
+### Added
+
+- Added the `append` and `append_into` functions.
+
 ## [0.2.0] - 2023-07-07
 
 ### Added
 
-- Added the `with_opt_value` and `push_opt` helper methods.
+- Added the `with_opt_value` and `push_opt` functions.
 
 ## [0.1.0] - 2023-07-07
 
 ### Internal
 
 - 🎉 Initial release.
 
+[0.3.0]: https://github.com/sunsided/query-string-builder/releases/tag/0.3.0
 [0.2.0]: https://github.com/sunsided/query-string-builder/releases/tag/0.2.0
 [0.1.0]: https://github.com/sunsided/query-string-builder/releases/tag/0.1.0

Cargo.toml

@@ -2,7 +2,7 @@
 name = "query-string-builder"
 description = "A query string builder for percent encoding key-value pairs"
 authors = ["Markus Mayer"]
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 repository = "https://github.com/sunsided/query-string-builder"
 keywords = ["url", "query-string", "query-argument"]

src/lib.rs

@@ -156,6 +156,49 @@ impl<'a> QueryString<'a> {
     pub fn is_empty(&self) -> bool {
         self.pairs.is_empty()
     }
+
+    /// Appends another query string builder's values.
+    ///
+    /// ## Example
+    ///
+    /// ```
+    /// use query_string_builder::QueryString;
+    ///
+    /// let mut qs = QueryString::new().with_value("q", "apple");
+    /// let more = QueryString::new().with_value("q", "pear");
+    ///
+    /// qs.append(more);
+    ///
+    /// assert_eq!(
+    ///     format!("https://example.com/{qs}"),
+    ///     "https://example.com/?q=apple&q=pear"
+    /// );
+    /// ```
+    pub fn append(&mut self, mut other: QueryString<'a>) {
+        self.pairs.append(&mut other.pairs)
+    }
+
+    /// Appends another query string builder's values, consuming both types.
+    ///
+    /// ## Example
+    ///
+    /// ```
+    /// use query_string_builder::QueryString;
+    ///
+    /// let qs = QueryString::new().with_value("q", "apple");
+    /// let more = QueryString::new().with_value("q", "pear");
+    ///
+    /// let qs = qs.append_into(more);
+    ///
+    /// assert_eq!(
+    ///     format!("https://example.com/{qs}"),
+    ///     "https://example.com/?q=apple&q=pear"
+    /// );
+    /// ```
+    pub fn append_into(mut self, mut other: QueryString<'a>) -> Self {
+        self.pairs.append(&mut other.pairs);
+        self
+    }
 }
 
 impl<'a> Display for QueryString<'a> {