# corewars
[![Latest Crates.io Release](https://img.shields.io/crates/v/corewars?label=corewars&logo=rust)](https://crates.io/crates/corewars)
[![Latest Github Release](https://img.shields.io/github/v/release/corewa-rs/corewars?label=Release&include_prereleases&logo=github)](https://github.com/corewa-rs/corewars/releases)
[![Build Status](https://img.shields.io/github/workflow/status/corewa-rs/corewars/ci/develop)](https://github.com/corewa-rs/corewars/actions)
A CLI interface for playing the classic programming battle game
[Core Wars](http://www.koth.org/index.html).
See the [website](https://corewa.rs) or the [Github repo](https://github.com/corewa-rs/corewars) for more details.
## Usage
```txt
Parse, assemble, and save Redcode files
USAGE:
corewars <input-file> <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
ARGS:
<input-file> Input file; use "-" to read from stdin
SUBCOMMANDS:
dump Save/print a program in "load file" format
help Prints this message or the help of the given subcommand(s)
```
### `dump` Usage
```txt
Save/print a program in "load file" format
USAGE:
corewars <input-file> dump [FLAGS] [OPTIONS]
FLAGS:
-h, --help Prints help information
-E, --no-expand Whether labels, expressions, macros, etc. should be resolved and expanded in the output
-V, --version Prints version information
OPTIONS:
-o, --output-file <output-file> Output file; defaults to stdout ("-") [default: -]
```