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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
/// # To-Binary: A Binary String Conversion Library
/// There are two types of Binary Strings that are present:
/// - "Binary String (0bString)"
/// - "Binary Whitespace String (0bWString)"


use hex::FromHexError;

/// # Conversion To Binary
/// The `ToBinary` Struct is used to convert from one data type to `binary strings`, or a string that only contains `0` and `1`
pub struct ToBinary;
pub struct FromBinary;

/// # Binary Usage
/// The `BinaryUsage` Struct is used to perform functions or actions on `Binary Strings`, such as:
/// 
/// - Adding/Removing Whitespace
/// - Asserting Binary Strings
/// - Asserting Binary Whitespace Strings
/// - Asserting Bytes
/// - Counting Bits
/// - Counting Bytes
pub struct BinaryUsage;

impl ToBinary {
    pub fn from_slice(byte_slice: &[u8]) -> String {
        let bytes: Vec<u8> = byte_slice.to_vec();
        
        let mut bin_string: String = String::new();

         for byte in bytes {
            bin_string.push_str(&format!("{:08b}",byte));
        }
        return bin_string
        
    }
    pub fn from_vector(bytes: Vec<u8>) -> String {
        let mut bin_string: String = String::new();

         for byte in bytes {
            bin_string.push_str(&format!("{:08b}",byte));
        }
        return bin_string
    }
    pub fn from_string(n: String) -> String {
        // Get Vector of Bytes From String
        let bytes: Vec<u8> = n.into_bytes();

        // Init a Binary String
        let mut bin_string: String = String::new();

         for byte in bytes {
            bin_string.push_str(&format!("{:08b}",byte));
        }
        return bin_string
    }
    pub fn from_hex<T: AsRef<str>>(n: T) -> Result<String,FromHexError> {
        // Decode as Hexadecimal and Unwrap
        let bytes: Vec<u8> = hex::decode(n.as_ref()).unwrap();
        
        // Init a Binary String
        let mut bin_string: String = String::new();
        
        
        for byte in bytes {
            bin_string.push_str(&format!("{:08b}",byte));
        }
        return Ok(bin_string)
    }
    pub fn from_str(n: &str) -> String {
        let bytes = n.as_bytes();

        let mut bin_string: String = String::new();

        for byte in bytes {
            bin_string.push_str(&format!("{:08b}",byte));
        }
        return bin_string
    }
}

impl BinaryUsage {
    /// Asserts The Input Is A `Binary String`, or a string with only:
    /// - `0`
    /// - `1`
    /// 
    /// This function is the same as `assert_binary_string()` just with a different name
    pub fn assert_binary(bin: String) -> bool {
        for x in bin.chars() {
            if x == '0' || x == '1' {

            }
            else {
                return false
            }
        }
        return true
    }
    /// Asserts the Input Is A `Binary String`, or a String with only: 
    /// - `0`
    /// - `1`
    /// - No Whitespace
    pub fn assert_binary_string(bin: String) -> bool {
        for x in bin.chars() {
            if x == '0' || x == '1' {

            }
            else {
                return false
            }
        }
        return true
    }
    /// Asserts The Input Is A `Binary Whitespace String`, or a String with only: 
    /// - `0`
    /// - `1`
    /// - `whitespace`
    /// TODO: Add a check for whitespace to be every 9nth character
    pub fn assert_binary_whitespace(bin: String) -> bool {
        for x in bin.chars() {
            if x == '0' || x == '1' || x == ' ' {
                
            }
            else {
                return false
            }
        }
        return true
    }
    /// Asserts The Input Has (`8` * `n`) bits or contains full bytes using the remainder function
    pub fn assert_bytes(bin: String) -> bool {
        if BinaryUsage::count_bits(bin).unwrap() % 8usize == 0usize {
            return true
        }
        else {
            return false
        }
    }
    /// Count number of bits for both a "Binary String" and "Binary Whitespace String" and returns a Result of either a `usize` or on error, empty response
    pub fn count_bits(bin: String) -> Result<usize,()> {
        if BinaryUsage::assert_binary_string(bin.clone()) == true {
            return Ok(bin.len())
        }
        else if BinaryUsage::assert_binary_whitespace(bin.clone()) == true {
            return Ok(BinaryUsage::remove_spaces(bin).len())
        }
        else {
            return Err(())
        }
    }
    /// Count number of bytes for both a "Binary String" and "Binary Whitespace String" and returns a Result of either a `usize` or on error, empty response
    pub fn count_bytes(bin: String) -> Result<usize,()> {
        if BinaryUsage::assert_bytes(bin.clone()) == true {
            return Ok(BinaryUsage::count_bits(bin).unwrap() / 8usize)
        }
        else {
            Err(())
        }
    }
    pub fn add_spaces(bin: String) -> Result<String,()> {
        // Checks to See If Its A Binary String (0bString)
        if BinaryUsage::assert_binary_string(bin.clone()) == true && BinaryUsage::assert_bytes(bin.clone()) {
            // Init Binary String With Spaces
            let mut binary_string_with_spaces = bin.clone();
            
            // Get Byte Count
            let bytes_to_index: usize = BinaryUsage::count_bytes(bin).unwrap() - 1usize;
            
            // Start Index Counter
            let mut counter: usize = 8;

            // Add Spaces At Index 8 + (9 * (bytes - 1))
            for _ in 0..bytes_to_index {
                binary_string_with_spaces.insert(counter, ' ');
                counter = counter + 9usize;
            }
            return Ok(binary_string_with_spaces)
        }
        else if BinaryUsage::assert_binary_whitespace(bin.clone()) == true {
            return Ok(bin)
        }
        else {
            Err(())
        }
    }
    /// Removes All Whitespace From String And Returns String
    pub fn remove_spaces(bin: String) -> String {
        bin.chars().filter(|c| !c.is_whitespace()).collect()
    }
}



#[cfg(test)]
mod tests {
    #[test]
    fn it_works() {
        assert_eq!(2 + 2, 4);
    }
}