rutie 0.10.0

The tie between Ruby and Rust.
Documentation 
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

use std::{convert::From, default::Default};

use crate::{
    binding::global::RubySpecialConsts,
    types::{InternalValue, Value, ValueType},
    AnyObject, Object, VerifiedObject,
};

/// `NilClass`
#[derive(Debug, Copy, Clone)]
#[repr(C)]
pub struct NilClass {
    value: Value,
}

impl NilClass {
    /// Creates a new instance of `NilClass` (`nil`).
    ///
    /// # Examples
    ///
    /// ```
    /// use rutie::{NilClass, Object, VM};
    /// # VM::init();
    ///
    /// assert!(NilClass::new().is_nil());
    /// ```
    ///
    /// Ruby:
    ///
    /// ```ruby
    /// nil.nil? == true
    /// ```
    pub fn new() -> Self {
        Self::from(Value::from(RubySpecialConsts::Nil as InternalValue))
    }
}

impl Default for NilClass {
    fn default() -> Self {
        NilClass::new()
    }
}

impl From<Value> for NilClass {
    fn from(value: Value) -> Self {
        NilClass { value }
    }
}

impl Into<Value> for NilClass {
    fn into(self) -> Value {
        self.value
    }
}

impl Into<AnyObject> for NilClass {
    fn into(self) -> AnyObject {
        AnyObject::from(self.value)
    }
}

impl Object for NilClass {
    #[inline]
    fn value(&self) -> Value {
        self.value
    }
}

impl VerifiedObject for NilClass {
    fn is_correct_type<T: Object>(object: &T) -> bool {
        object.value().ty() == ValueType::Nil
    }

    fn error_message() -> &'static str {
        "Error converting to NilClass"
    }
}

impl PartialEq for NilClass {
    fn eq(&self, other: &Self) -> bool {
        self.equals(other)
    }
}

#[cfg(test)]
mod tests {
    use crate::{AnyObject, Boolean, NilClass, Object, VerifiedObject, VM};

    #[test]
    fn test_nil_class() {
        crate::on_ruby_thread(|| {
            let nil = NilClass::new();
            assert!(nil.is_nil());
            assert_eq!(nil, NilClass::default());

            let any: AnyObject = nil.into();
            assert!(NilClass::is_correct_type(&any));
            assert!(!NilClass::is_correct_type(&Boolean::new(false)));
            assert!(Boolean::new(false).try_convert_to::<NilClass>().is_err());

            assert!(VM::eval("[].first")
                .unwrap()
                .try_convert_to::<NilClass>()
                .is_ok());
        });
    }
}