wemo 0.0.12

A library for interacting with Belkin WeMo home automation devices.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

// Copyright (c) 2016 Brandon Thomas <bt@brand.io, echelon@gmail.com>

use std::error::Error;
use std::fmt::Display;
use std::fmt::Formatter;
use std::fmt::Result;
use std::io::Error as IoError;

// TODO: Work in progress unifying errors.
// TODO: Alphabetize
/// Represents all of the various types of errors reported by the wemo.rs
/// library. (TODO: Work in progress unifying errors.)
#[derive(Debug)]
pub enum WemoError {
  /// Indicates that there was trouble understanding the WeMo device response.
  BadResponseError,

  /// Wraps an std::io::Error.
  IoError { cause: IoError },

  /// Couldn't parse the XML received from Wemo.
  ParsingError,

  /// Indicates that a communication timeout elapsed.
  TimeoutError,

  /// Indicates that the WeMo reported a problem during the request.
  WemoError,

  /// Indicates a problem with the Iron/Hyper server.
  IronError,

  /// Inability to obtain a lock, etc. Shouldn't occur.
  LockError,

  SubscriptionError,

  /// Could not determine local IP address.
  NoLocalIp,
}

impl From<IoError> for WemoError {
  fn from(error: IoError) -> WemoError {
    WemoError::IoError { cause: error }
  }
}

impl Error for WemoError {
  fn description(&self) -> &str {
    "TODO" // TODO: Actual description based on enum variant
  }
}

impl Display for WemoError {
  fn fmt(&self, f: &mut Formatter) -> Result {
    write!(f, "WemoError") // TODO: Include enum variants
  }
}