https://github.com/fornwall/rust-script

Run Rust files and expressions as scripts without any setup or compilation step.
https://github.com/fornwall/rust-script

cargo rust script

Last synced: 2 days ago
JSON representation

Run Rust files and expressions as scripts without any setup or compilation step.

• Host: GitHub
• URL: https://github.com/fornwall/rust-script
• Owner: fornwall
• License: apache-2.0
• Created: 2020-10-24T21:00:13.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-09-03T09:37:12.000Z (3 months ago)
• Last Synced: 2024-10-29T15:27:52.833Z (about 1 month ago)
• Topics: cargo, rust, script
• Language: Rust
• Homepage: https://rust-script.org
• Size: 694 KB
• Stars: 1,251
• Watchers: 14
• Forks: 43
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

• awesome-starred - fornwall/rust-script - Run Rust files and expressions as scripts without any setup or compilation step. (rust)

README

        

[![CI](https://github.com/fornwall/rust-script/workflows/CI/badge.svg)](https://github.com/fornwall/rust-script/actions?query=workflow%3ACI)

[![Crates.io](https://img.shields.io/crates/v/rust-script.svg)](https://crates.io/crates/rust-script)

[![MSRV](https://img.shields.io/badge/rustc-1.74.0+-ab6000.svg)](https://blog.rust-lang.org/2023/11/16/Rust-1.74.0.html)

# rust-script

Run Rust script files without any setup or explicit compilation step, with seamless use of crates specified as dependencies inside the scripts.

```sh

$ cargo install rust-script

[...]

$ cat script.rs

#!/usr/bin/env rust-script

//! Dependencies can be specified in the script file itself as follows:

//!

//! ```cargo

//! [dependencies]

//! rand = "0.8.0"

//! ```

use rand::prelude::*;

fn main() {

    let x: u64 = random();

    println!("A random number: {}", x);

}

$ ./script.rs

A random number: 9240261453149857564

```

Rust version 1.74 or newer required.

See the [documentation at rust-script.org](https://rust-script.org).

## Related projects

- [cargo-script](https://github.com/DanielKeep/cargo-script) - the unmaintained project that `rust-script` was forked from.

- [cargo-eval](https://github.com/reitermarkus/cargo-eval/) - maintained fork of `cargo-script`.

- [cargo-play](https://github.com/fanzeyi/cargo-play) - local Rust playground.

- [runner](https://github.com/stevedonovan/runner/) - tool for running Rust snippets.

- [scriptisto](https://github.com/igor-petruk/scriptisto) - language-agnostic "shebang interpreter" that enables you to write scripts in compiled languages.

- [official cargo-script RFC](https://github.com/rust-lang/cargo/issues/12207) - in progress integration into cargo

## License

`rust-script` is primarily distributed under the terms of both the [MIT license](LICENSE-MIT) and the [Apache License (Version 2.0)](LICENSE-APACHE).