glib: Add optional support for serialization and deserialization with…

… serde

This feature is gated as `serde`

Supports both serialization and deserialization:
- glib::Bytes
- glib::GString (with in-place deserialization)

Supports serialization only:
- glib::ByteArray
- glib::GStr
- glib::StrV

Collection types are also supported  as long as the type parameters implement the necessary traits:
- glib::Slice<T: TransparentType + _>
- glib::PtrSlice<T: TransparentPtrType + _>
- glib::List<T: TransparentPtrType + _>
- glib::SList<T: TransparentPtrType + _>

.github/workflows/CI.yml

@@ -82,9 +82,15 @@ jobs:
       - name: build
         run: cargo build --manifest-path ${{ matrix.conf.name }}/Cargo.toml --features "${{ matrix.conf.features }}"
         if: matrix.rust != 'nightly'
+      - name: build-serde
+        run: cargo build --manifest-path ${{ matrix.conf.name }}/Cargo.toml --features "${{ matrix.conf.features }},serde"
+        if: matrix.rust != 'nightly' && matrix.conf_name == 'glib'
       - name: tests
         run: cargo test --manifest-path ${{ matrix.conf.name }}/Cargo.toml --features "${{ matrix.conf.features }}"
         if: matrix.rust != 'nightly'
+      - name: test-serde
+        run: cargo test --manifest-path ${{ matrix.conf.name }}/Cargo.toml --features "${{ matrix.conf.features }},serde"
+        if: matrix.rust != 'nightly' && matrix.conf_name == 'glib'
       - name: Test ${{ matrix.conf.name }}/sys
         run: cargo test
         working-directory: ${{ matrix.conf.name }}/sys

glib/Cargo.toml

@@ -35,12 +35,14 @@ smallvec = "1.0"
 thiserror = "1"
 gio_ffi = { package = "gio-sys", path = "../gio/sys", optional = true }
 memchr = "2.5.0"
+serde = { version = "1.0", optional = true }
 
 [dev-dependencies]
 tempfile = "3"
 gir-format-check = "^0.1"
 trybuild2 = "1"
 criterion = "0.4.0"
+serde_json = "1.0"
 
 [features]
 default = ["gio"]
@@ -59,6 +61,7 @@ log_macros = ["log"]
 dox = ["ffi/dox", "gobject_ffi/dox", "log_macros"]
 compiletests = []
 gio = ["gio_ffi"]
+serde = ["dep:serde"]
 
 [package.metadata.docs.rs]
 features = ["dox"]

glib/README.md

@@ -96,6 +96,16 @@ glib = "0.13"
 glib = { git = "https://github.com/gtk-rs/gtk-rs-core.git", package = "glib" }
 ```
 
+### Serialization with Serde
+
+If you want to serialize (and deserialize) some GLib types (e.g. `GString`) with Serde, you can enable the `serde` feature:
+
+```toml
+glib = { version = "0.18", features = ["serde"] }
+```
+
+This library implements serialization and deserialization as described in the `serde@^1.0` API.
+
 ## License
 
 __glib__ is available under the MIT License, please refer to it.

glib/src/lib.rs

@@ -213,6 +213,9 @@ pub use self::thread_pool::{ThreadHandle, ThreadPool};
 
 pub mod thread_guard;
 
+#[cfg(feature = "serde")]
+mod serde;
+
 // rustdoc-stripper-ignore-next
 /// This is the log domain used by the [`clone!`][crate::clone!] macro. If you want to use a custom
 /// logger (it prints to stdout by default), you can set your own logger using the corresponding