Rust-101

Rust-101 is a repository that serves as a starting point for learning Rust programming. This repository contains example code, exercises, and resources to help you get started with Rust, a modern systems programming language known for its safety, speed, and concurrency features.

Table of Contents

• Rust-101
  • Table of Contents
  • Getting Started
  • Code Directory
  • Cargo Directory
  • Notebooks
    • How to Use Rust Notebooks
  • Exercises
  • Contributing
  • License

Getting Started

To get started with Rust-101, you'll need to have Rust and Cargo (the Rust package manager) installed on your system. If you haven't already, you can install Rust by following the instructions on the official Rust website.

Once you have Rust and Cargo installed, you can clone this repository:

git clone https://github.com/qcversity/Rust-101.git
cd Rust-101

Code Directory

The Code directory contains various Rust code examples that demonstrate different aspects of the Rust programming language. You can explore these examples to understand Rust syntax, data types, and common programming patterns.

Cargo Directory

The Cargo directory contains a collection of scripts that demonstrate how to utilize the Cargo tool, which is the official build manager and package manager for the Rust programming language. These scripts are available in various formats, including batch and powershell files for Windows, and bash scripts for Unix-based systems. They serve as practical examples of how to work with Cargo to create, manage, and build Rust projects efficiently.

• create_project.bat: This batch script showcases how to create a new Rust project using Cargo in a Windows environment. It initiates the project creation process and ensures that the necessary directory structure and files are set up.

• create_project.ps1: The PowerShell script for Windows accomplishes the same task as create_project.bat. It demonstrates how to create a new Rust project with Cargo in a Windows environment but using PowerShell.

• create_project.sh: The bash script is designed for Unix-based systems like Linux and macOS. It performs the task of creating a new Rust project using Cargo in a Unix-based environment.

Each of these scripts provides practical examples for working with Rust projects and demonstrates the versatility of Cargo across different operating systems.

Notebooks

The Notebooks directory in this repository contains Jupyter notebooks written in Rust. These notebooks are a great resource for learning and experimenting with Rust in an interactive and documentation-friendly environment. Each notebook provides a hands-on approach to understanding various Rust concepts and can be a valuable resource for both beginners and experienced Rust programmers.

How to Use Rust Notebooks

1. Ensure you have the evcxr_jupyter tool installed for Rust. If not, refer to the Setting up Rust section for instructions.

2. Start a Jupyter Notebook server using jupyter notebook or jupyter lab.

3. Navigate to the Notebooks directory, where you can find a collection of Rust notebooks.

4. Open a notebook by clicking on its filename.

5. You can run the code cells in the notebook to see the results interactively and explore the Rust code examples provided.

These notebooks are designed to be a practical companion to your Rust learning journey. Explore, modify, and experiment with the Rust code within the notebooks to get the best out of these notebooks, and I hope they will helpful in your Rust programming endeabvors.

Exercises

The exercises directory contains a set of coding exercises to help you practice and deepen your understanding of Rust. These exercises cover a range of topics and difficulty levels, making them suitable for beginners and more experienced Rust programmers.

If you're new to Rust, we recommend starting with the exercises in the beginner directory. As you become more comfortable with the language, you can tackle the challenges in the intermediate and advanced directories.

Contributing

We welcome contributions from the Rust community! If you have code examples, exercises, or documentation improvements to offer, please feel free to open a pull request.

1. Fork this repository.
2. Create a new branch for your changes.
3. Make your changes, add new examples, or improve existing ones.
4. Test your changes if applicable.
5. Commit your changes and create a descriptive pull request.
6. Provide a clear and informative description of your contributions.

We appreciate your help in making Rust-101 a valuable resource for Rust learners.

License

Rust-101 by Dr Saad Laouadi is licensed under CC BY-SA 4.0