Add serde option

Signed-off-by: Patrick José Pereira <patrickelectric@gmail.com>

Author: patrickelectric

Cargo.toml

@@ -12,7 +12,9 @@ readme = "README.md"
 [dependencies]
 derivative = "1.0.3"
 libc = "0.2"
+serde_derive = { version = "1.0.104", optional = true }
 
 [features]
 no_wrapper = []
 static = []
+default = ["serde_derive"]

src/lib.rs

@@ -49,6 +49,9 @@ pub use v4l2::pubconsts as consts;
 
 pub type Result<T> = result::Result<T, Error>;
 
+#[cfg(feature = "serde")]
+use serde::Serialize;
+
 #[macro_use]
 extern crate derivative;
 
@@ -107,6 +110,7 @@ impl From<io::Error> for Error {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct Config<'a> {
     /// The mix of numerator and denominator. v4l2 uses frame intervals instead of frame rates.
     /// Default is `(1, 10)`.
@@ -138,6 +142,7 @@ impl<'a> Default for Config<'a> {
     }
 }
 
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct FormatInfo {
     /// FourCC of format (e.g. `b"H264"`).
     pub format: [u8; 4],
@@ -250,6 +255,7 @@ impl fmt::Debug for IntervalInfo {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct Frame {
     /// Width and height of the frame.
     pub resolution: (u32, u32),
@@ -293,6 +299,7 @@ enum State {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct Camera {
     fd: RawFd,
     state: State,
@@ -705,6 +712,7 @@ impl Drop for Camera {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct FormatIter<'a> {
     camera: &'a Camera,
     index: u32,
@@ -733,6 +741,7 @@ impl<'a> Iterator for FormatIter<'a> {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct ControlIter<'a> {
     camera: &'a Camera,
     id: u32,
@@ -796,6 +805,7 @@ impl Settable for String {
 }
 
 #[derive(Debug, Clone)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct Control {
     pub id: u32,
     pub name: String,
@@ -805,6 +815,7 @@ pub struct Control {
 }
 
 #[derive(Debug, Clone)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub enum CtrlData {
     Integer {
         value: i32,
@@ -851,12 +862,14 @@ pub enum CtrlData {
 }
 
 #[derive(Debug, Clone)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct CtrlMenuItem {
     pub index: u32,
     pub name: String,
 }
 
 #[derive(Debug, Clone)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 pub struct CtrlIntMenuItem {
     pub index: u32,
     pub value: i64,

src/v4l2.rs

@@ -135,6 +135,7 @@ pub fn mmap(length: usize, fd: RawFd, offset: usize) -> io::Result<MappedRegion>
 
 #[derive(Derivative)]
 #[derivative(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Format {
     pub ftype: u32,
@@ -167,6 +168,7 @@ impl Format {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct PixFormat {
     pub width: u32,
@@ -194,6 +196,7 @@ impl PixFormat {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct RequestBuffers {
     pub count: u32,
@@ -215,6 +218,7 @@ impl RequestBuffers {
 
 #[derive(Derivative)]
 #[derivative(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Buffer {
     pub index: u32,
@@ -243,6 +247,7 @@ impl Buffer {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct TimeCode {
     pub ttype: u32,
@@ -255,6 +260,7 @@ pub struct TimeCode {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct FmtDesc {
     pub index: u32,
@@ -275,6 +281,7 @@ impl FmtDesc {
 
 #[derive(Derivative)]
 #[derivative(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct StreamParm {
     pub ptype: u32,
@@ -294,6 +301,7 @@ impl StreamParm {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct CaptureParm {
     pub capability: u32,
@@ -305,13 +313,15 @@ pub struct CaptureParm {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Fract {
     pub numerator: u32,
     pub denominator: u32,
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Frmsizeenum {
     pub index: u32,
@@ -338,13 +348,15 @@ impl Frmsizeenum {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct FrmsizeDiscrete {
     pub width: u32,
     pub height: u32,
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct FrmsizeStepwise {
     pub min_width: u32,
@@ -356,6 +368,7 @@ pub struct FrmsizeStepwise {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Frmivalenum {
     pub index: u32,
@@ -386,6 +399,7 @@ impl Frmivalenum {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct FrmivalStepwise {
     pub min: Fract,
@@ -394,6 +408,7 @@ pub struct FrmivalStepwise {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct QueryCtrl {
     pub id: u32,
@@ -416,6 +431,7 @@ impl QueryCtrl {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct QueryExtCtrl {
     pub id: u32,
@@ -444,6 +460,7 @@ impl QueryExtCtrl {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C, packed)]
 pub struct QueryMenu {
     pub id: u32,
@@ -483,6 +500,7 @@ impl QueryMenuData {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct Control {
     pub id: u32,
@@ -496,6 +514,7 @@ impl Control {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C, packed)]
 pub struct ExtControl {
     pub id: u32,
@@ -516,6 +535,7 @@ impl ExtControl {
 }
 
 #[derive(Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize))]
 #[repr(C)]
 pub struct ExtControls<'a> {
     pub ctrl_class: u32,