Skip to content
Branch: master
Find file History
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
README.md [hw0] remove classroom link Feb 11, 2016

README.md

Homework 00: Hello Rust & Hello Cargo!

Due 2016-01-25, 11:59pm.

For questions, please post on Piazza (Penn students) or Google Groups (other). Links on homepage.

Classroom for GitHub

We're using Classroom for GitHub, which manages private homework repositories for students. To create your very own private homework repository (owned by us), click the link on the course Piazza.

If there is no starter code, such as in this homework, you can use Cargo to initialize the git repository for you. See below. But first, Rust!

Installing Rust

For this homework, all you'll have to do is install the Rust compiler (rustc) and the Rust package manager (Cargo). We'll be using Rust v1.6 for this class. (Version 1.6 is set to be released next Thursday! This homework doesn't depend on the version of Rust, so it's fine to get started early.)

We recommend using multirust, a tool to manage multiple installations of Rust on your system. Multirust supports Linux, OS X, and Windows (via MSYS2). Unfortunately, there is no support for Windows if you are not using MSYS2.

Multirust maintains a user default toolchain version (stable, beta, or nightly). Run multirust default stable to set your user preference to stable. This will also download the stable toolchain.

On Linux, OS X, or Windows+MSYS2: Install multirust by following the instructions on their README. You can also use your local friendly package manager.

On Windows (without MSYS2): You can either use the standard Rust installer from the website, or you can use multirust on Eniac.

On Eniac: If you don't want to install Rust, multirust is also available on Eniac. Add this line to your ~/.bashrc on Eniac: export PATH=$PATH:/home1/c/cis198/local/bin

To check that Rust and Cargo are installed properly, run the following commands and make sure the output matches below:

$ rustc --version
rustc 1.5.0 (3d7cd77e4 2015-12-04)
$ cargo --version
cargo 0.6.0-nightly (e1ed995 2015-10-22)

When version 1.6 is released next week, you should update your version of Rust, using multirust update stable.

Hello, Rust!

Now that Rust is ready to roll, let's write our first "hello world" program. Create a file named main.rs and modify the code snippet below to print out "Hello, <your name>!".

fn main() {
    let name = "Ferris"; // Ferris is the name of Rust's unofficial crustacean mascot
    println!("Hello, {}!", name);
}

Once you've created your program, compile it using rustc main.rs and run the resulting main binary to test it. Boom! You did it! You're a Rust programmer now! 🎊🎉👍

Hello, Cargo!

Rust has a fantastic package and build manager, Cargo, which is modeled from years of learning from other languages. Cargo handles all the gory build automation and dependency management details for you, so that you don't have to worry about it when creating (or building or updating) a project.

Using rustc directly is fine for small projects, but Cargo really helps to remove a lot of the friction of manual project management. If you've ever used rake or pip for dependency management, Cargo is like those, plus all of the build power provided by a good Makefile.

To make a new project for homework 0, run the command cargo new --bin hw00 (which will create the folder hw00).

Why --bin? We want this project to create a standalone executable, rather than a library that can be rolled into other projects.

If you are not already in a git repository when you create your project, Cargo will create a git repository (and .gitignore) for you. Then, you can add this your GitHub repository as a git remote as follows:

git remote add origin git@github.com:cis198-2016s/hw00-<username>.git
git push -u origin master

Cargo creates this directory structure for you:

hw00
├── Cargo.toml
└── src
    └── main.rs

1 directory, 2 files

You may notice that the main.rs file Cargo creates looks suspiciously similar to the "Hello World" code above. Since you've already written your "Hello World" program, move the file you created into src, and overwrite the main.rs that Cargo generated.

To finish things off, let's build our project. Simply run cargo build from any directory in the project tree! You can run your executable with cargo run. Pretty magic, huh?

Bonus: Configuration

Adding to your personal environment setup is one of the many joys of starting a new programming language. Rust has a pretty decent amount of support for being new to the game.

Take a look at this list of editor configs. There are more unofficial or less-supported ones out there, so it's worth looking around. If you aren't sure what to use, all three of your instructors use vim :)

Submission

Commit and push your work to the master branch of your Classroom for Github repository for this HW. Make sure it is visible on Github! This is your submission. (Work must be in the master branch at the due time.)

That's it! ok bye get outta here 👉

You can’t perform that action at this time.