gcj-helper

gcj-helper is a Rust library for writing Google Code Jam solutions. It handles the boilerplate so you can focus on writing solutions instead.

Examples

Sequential computation

```rust extern crate gcj_helper;

use gcj_helper::TestEngine; use std::io::Write;

fn main() { TestEngine::new("./foo.in", "./foo.out").run(|input, output| { writeln!(output, " {}", input.readnextline()) }); } ```

Parallel computation

```rust extern crate gcj_helper;

use gcj_helper::TestEngine;

fn main() { TestEngine::new("./foo.in", "./foo.out") .runparallel(|input| input.readnext_line(), |data| format!(" {}\n", data)); } ```

Usage

Via cargo new --template

For brand-new crates, the quickest way to get started is to use a Cargo template:

text cargo new --template https://github.com/FaultyRAM/gcj-template-rust.git foobar

This creates a new crate named foobar that uses gcj-helper's sequential API. If you want to use the parallel API instead, in Cargo.toml replace this line:

toml gcj-helper = "0.3"

With this line:

toml gcj-helper = { version = "0.3", features = ["parallel"] }

And in src/main.rs, replace the call to TestEngine::new() with a call to TestEngine::new_parallel() as shown above.

By hand

You can also manually add gcj-helper to your crate, though doing so is slower than using cargo new --template. To do this, either add this to your [dependencies] in Cargo.toml:

toml gcj-helper = "0.3"

Or if you want to use the parallel API, add this instead:

toml gcj-helper = { version = "0.3", features = ["parallel"] }

After adding gcj-helper to Cargo.toml, add this to your crate root:

rust extern crate gcj_helper;

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.