mif 0.3.0

Memory Initialization File
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

//! `mif` binary.

#![forbid(unsafe_code)]
#![forbid(missing_docs)]

use std::{path::PathBuf, io::stdout};
use clap::{crate_version, crate_authors, Clap, AppSettings};
use anyhow::Result;
use mif::{First, cli::{open, dump, load, join}};
use Mif::{Dump, Join};

/// Memory Initialization File.
#[derive(Clap)]
#[clap(
	version = crate_version!(),
	author = crate_authors!(),
	max_term_width = 80,
	global_setting = AppSettings::ColoredHelp,
	global_setting = AppSettings::DeriveDisplayOrder,
	global_setting = AppSettings::UnifiedHelpMessage,
	global_setting = AppSettings::ArgRequiredElseHelp,
)]
enum Mif {
	/// Dumps binary as MIF.
	Dump {
		/// Input file or standard input (-).
		#[clap(default_value = "-")]
		input: PathBuf,
		/// Word width in bits from 1 to 128.
		#[clap(short = "w", long = "width", value_name = "bits")]
		#[clap(default_value = "16")]
		width: usize,
		/// LSB/MSB first (little/big-endian).
		#[clap(short = "f", long = "first", value_name = "lsb|msb")]
		#[clap(default_value = "lsb")]
		first: First,
	},
	/// Joins binaries' memory areas to MIFs.
	Join {
		/// TOML file or standard input (-).
		#[clap(default_value = "-")]
		toml: PathBuf,
		/// Input directory [default: .].
		#[clap(short = "i", long = "bins", value_name = "path")]
		bins: Option<PathBuf>, // `default_value = ""` broken for non-pos opts.
		/// Output directory [default: .].
		#[clap(short = "o", long = "mifs", value_name = "path")]
		mifs: Option<PathBuf>, // `default_value = ""` broken for non-pos opts.
		/// No comments in MIFs.
		#[clap(short = "n", long = "no-comments")]
		nocs: bool,
	},
}

fn main() -> Result<()> {
	match Mif::parse() {
		Dump { input, width, first } => {
			let (mut bytes, count) = open(&input)?;
			dump(&mut stdout(), &mut bytes, count, width, first)
		},
		Join { toml, bins, mifs, nocs } => {
			let bins = bins.unwrap_or_default();
			let mifs = mifs.unwrap_or_default();
			join(&load(&toml)?, (&bins, &mifs), !nocs)
		},
	}
}