libxas 0.1.0

Extendable Assembler library
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

// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * libxas: Extendable Assembler Library
 * Copyright (C) 2022 Amy Parker <apark0006@student.cerritos.edu>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA or visit
 * the GNU Project at <https://gnu.org/licenses>. The GNU General Public
 * License version 2 is available at, for your convenience,
 * <https://gnu.org/licenses/old-licenses/gpl-2.0.html>.
 */

use crate::errors::lpanic;

#[derive(Clone, Debug)]
pub enum PlatformArch {
    #[cfg(feature = "chip8-raw")]
    ChipEightRaw,
    #[cfg(feature = "chip8")]
    ChipEight,
}

#[derive(Clone, Debug)]
pub enum PlatformTarget {
    #[cfg(feature = "rawbin")]
    RawBinary,
}

#[derive(Clone, Debug)]
pub struct Platform {
    pub arch: PlatformArch,
    pub target: PlatformTarget,
}

// TODO: proper error handling, return Result<Err> instead of panic
// TODO: overall since this is a library everything needs to be converted
// to error types, the library should NEVER panic - that's the responsibility
// of executables!
// TODO: general consideration CROSS-LIBRARY, change String to &String wherever
// possible. Allows passing string literals (&String = &str) and reduces call
// changes between str and String.
impl Platform {
    pub fn from_platform_info(arch: &str, target: &str) -> Self {
        Platform {
            // TODO: consider using some kind of lookup table?
            arch: match arch.to_lowercase().as_str() {
                #[cfg(feature = "chip8-raw")]
                "chipeightraw" | "chip8raw" | "c8r" | "chip8r" => PlatformArch::ChipEightRaw,
                #[cfg(feature = "chip8")]
                "chipeight" | "chip8" | "c8" => PlatformArch::ChipEight,
                _ => lpanic("unsupported arch"),
            },
            target: match target.to_lowercase().as_str() {
                #[cfg(feature = "rawbin")]
                "bin" | "binary" | "raw" | "rawbin" | "rawbinary" => PlatformTarget::RawBinary,
                _ => lpanic("unsupported target"),
            },
        }
    }
    pub fn from_platform_double(t: &str) -> Self {
        let n: Vec<String> = t.split('-').map(|x| x.to_string()).collect();
        Self::from_platform_info(&n[0], &n[1])
    }
    // True = little, False = big
    pub fn get_endianness(&self) -> bool {
        match self.arch {
            #[cfg(feature = "chip8")]
            PlatformArch::ChipEight => false,
            #[cfg(feature = "chip8-raw")]
            PlatformArch::ChipEightRaw => false,
            // _ => lpanic("unsupported arch")
        }
    }
}