rust / build: Remove the rust tool

Sadly, there's a lack of resources for maintaining the `rust` tool,
and we decided in the 2013-10-08 Rust team meeting that it's better
to remove it altogether than to leave it in a broken state.

This deletion is without prejudice. If a person or people appear who
would like to maintain the tool, we will probably be happy to
resurrect it!

Closes #9775
This commit is contained in:
Tim Chevalier 2013-10-09 12:13:43 -07:00
parent 62812f1e38
commit a9dddbacde
8 changed files with 1 additions and 442 deletions

View file

@ -1,256 +0,0 @@
// Copyright 2013 The Rust Project Developers. See the COPYRIGHT
// file at the top-level directory of this distribution and at
// http://rust-lang.org/COPYRIGHT.
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.
// rust - central access to other rust tools
// FIXME #2238 Make commands run and test emit proper file endings on windows
// FIXME #2238 Make run only accept source that emits an executable
#[link(name = "rust",
vers = "0.9-pre",
uuid = "4a24da33-5cc8-4037-9352-2cbe9bd9d27c",
url = "https://github.com/mozilla/rust/tree/master/src/rust")];
#[license = "MIT/ASL2"];
#[crate_type = "lib"];
extern mod rustpkg;
extern mod rustdoc;
extern mod rusti;
extern mod rustc;
use std::io;
use std::os;
use std::run;
enum ValidUsage {
Valid(int), Invalid
}
impl ValidUsage {
fn is_valid(&self) -> bool {
match *self {
Valid(_) => true,
Invalid => false
}
}
}
enum Action {
Call(extern "Rust" fn(args: &[~str]) -> ValidUsage),
CallMain(&'static str, extern "Rust" fn(&[~str]) -> int),
}
enum UsageSource<'self> {
UsgStr(&'self str),
UsgCall(extern "Rust" fn()),
}
struct Command<'self> {
cmd: &'self str,
action: Action,
usage_line: &'self str,
usage_full: UsageSource<'self>,
}
static COMMANDS: &'static [Command<'static>] = &'static [
Command {
cmd: "build",
action: CallMain("rustc", rustc::main_args),
usage_line: "compile rust source files",
usage_full: UsgCall(rustc_help),
},
Command {
cmd: "run",
action: Call(cmd_run),
usage_line: "build an executable, and run it",
usage_full: UsgStr(
"The run command is an shortcut for the command line \n\
\"rustc <filename> -o <filestem>~ && ./<filestem>~ [<arguments>...]\".\
\n\nUsage:\trust run <filename> [<arguments>...]"
)
},
Command {
cmd: "test",
action: Call(cmd_test),
usage_line: "build a test executable, and run it",
usage_full: UsgStr(
"The test command is an shortcut for the command line \n\
\"rustc --test <filename> -o <filestem>test~ && \
./<filestem>test~ [<arguments>...]\"\
\n\nUsage:\trust test <filename> [<arguments>...]"
)
},
Command {
cmd: "doc",
action: CallMain("rustdoc", rustdoc::main_args),
usage_line: "generate documentation from doc comments",
usage_full: UsgCall(rustdoc_help),
},
Command {
cmd: "pkg",
action: CallMain("rustpkg", rustpkg::main_args),
usage_line: "download, build, install rust packages",
usage_full: UsgCall(rustpkg::usage::general),
},
Command {
cmd: "sketch",
action: CallMain("rusti", rusti::main_args),
usage_line: "run a rust interpreter",
usage_full: UsgStr("\nUsage:\trusti"),
},
Command {
cmd: "help",
action: Call(cmd_help),
usage_line: "show detailed usage of a command",
usage_full: UsgStr(
"The help command displays the usage text of another command.\n\
The text is either build in, or provided by the corresponding \
program.\n\nUsage:\trust help <command>"
)
}
];
fn rustc_help() {
rustc::usage(os::args()[0].clone())
}
fn rustdoc_help() {
rustdoc::usage(os::args()[0].clone())
}
fn find_cmd(command_string: &str) -> Option<Command> {
do COMMANDS.iter().find |command| {
command.cmd == command_string
}.map(|x| *x)
}
fn cmd_help(args: &[~str]) -> ValidUsage {
fn print_usage(command_string: ~str) -> ValidUsage {
match find_cmd(command_string) {
Some(command) => {
match command.action {
CallMain(prog, _) => println!(
"The {} command is an alias for the {} program.",
command.cmd, prog),
_ => ()
}
match command.usage_full {
UsgStr(msg) => println!("{}\n", msg),
UsgCall(f) => f(),
}
Valid(0)
},
None => Invalid
}
}
match args {
[ref command_string] => print_usage((*command_string).clone()),
_ => Invalid
}
}
fn cmd_test(args: &[~str]) -> ValidUsage {
match args {
[ref filename, ..prog_args] => {
let p = Path(*filename);
let test_exec = p.filestem().unwrap() + "test~";
invoke("rustc", &[~"--test", filename.to_owned(),
~"-o", test_exec.to_owned()], rustc::main_args);
let exit_code = run::process_status(~"./" + test_exec, prog_args);
Valid(exit_code)
}
_ => Invalid
}
}
fn cmd_run(args: &[~str]) -> ValidUsage {
match args {
[ref filename, ..prog_args] => {
let p = Path(*filename);
let exec = p.filestem().unwrap() + "~";
invoke("rustc", &[filename.to_owned(), ~"-o", exec.to_owned()],
rustc::main_args);
let exit_code = run::process_status(~"./"+exec, prog_args);
Valid(exit_code)
}
_ => Invalid
}
}
fn invoke(prog: &str, args: &[~str], f: &fn(&[~str]) -> int) -> int {
let mut osargs = ~[prog.to_owned()];
osargs.push_all_move(args.to_owned());
f(osargs)
}
fn do_command(command: &Command, args: &[~str]) -> ValidUsage {
match command.action {
Call(f) => f(args),
CallMain(prog, f) => {
Valid(invoke(prog, args, f))
}
}
}
fn usage() {
static INDENT: uint = 8;
io::print(
"The rust tool is a convenience for managing rust source code.\n\
It acts as a shortcut for programs of the rust tool chain.\n\
\n\
Usage:\trust <command> [arguments]\n\
\n\
The commands are:\n\
\n"
);
for command in COMMANDS.iter() {
let padding = " ".repeat(INDENT - command.cmd.len());
println!(" {}{}{}", command.cmd, padding, command.usage_line);
}
io::print(
"\n\
Use \"rust help <command>\" for more information about a command.\n\
\n"
);
}
pub fn main() {
#[fixed_stack_segment]; #[inline(never)];
let os_args = os::args();
if (os_args.len() > 1 && (os_args[1] == ~"-v" || os_args[1] == ~"--version")) {
rustc::version(os_args[0]);
return;
}
let args = os_args.tail();
if !args.is_empty() {
let r = find_cmd(*args.head());
for command in r.iter() {
let result = do_command(command, args.tail());
match result {
Valid(exit_code) => {
os::set_exit_status(exit_code);
return;
}
_ => {}
}
}
}
usage();
}