# ractor-tutorial

**Repository Path**: rustup/ractor-tutorial

## Basic Information

- **Project Name**: ractor-tutorial
- **Description**: ractor 设计原理(手册)
- **Primary Language**: Rust
- **License**: CC0-1.0
- **Default Branch**: master
- **Homepage**: https://github.com/nsengupta/ractor-tutorial
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-25
- **Last Updated**: 2024-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ractor-tutorial

In the past, I have had the opportunity to learn and apply Actor-based design (using [#akka](https://www.linkedin.com/feed/hashtag/?keywords=akka&highlightedUpdateUrns=urn%3Ali%3Aactivity%3A7092388425978277888) ) in about 3 production software. I loved the way I could model the behaviour using Actors (and [#fsm](https://www.linkedin.com/feed/hashtag/?keywords=fsm&highlightedUpdateUrns=urn%3Ali%3Aactivity%3A7092388425978277888)) using [#scala](https://www.linkedin.com/feed/hashtag/?keywords=scala&highlightedUpdateUrns=urn%3Ali%3Aactivity%3A7092388425978277888) and [#java](https://www.linkedin.com/feed/hashtag/?keywords=java&highlightedUpdateUrns=urn%3Ali%3Aactivity%3A7092388425978277888).  

As a Rust enthusiast, I was searching for Actor-based libraries and 
chanced upon **ractor** ([github](https://github.com/slawlor/ractor))  , which mirrored the behavior of Erlang's. 

I have captured my understanding during and after the exploration of 
`ractor` in the form of tutorials; in 3 parts, just so that reading each doesn't become
 too heavy.

-------------------------------------------------

Important: this repository replaces the 3 individual repositories that I had 
created earlier. Each of those 3 repositories contained one tutorial. They 
were in a series named as `rust-ractor-tutorial-(1, 2, 3)`. This arrangement 
made maintenance of the tutorials easier but made reading quite cumbersome, 
what with all the jumping around repositories. Based upon suggestions 
received in LinkedIn's Rust Programming Language [forum](https://www.linkedin.com/groups/4973032/), I have combined those earlier 3 tutorials 
into 1, which is this repository. It walks one through the world 
of Actors as implemented by 'ractor' framework.

I have retired the 3 older repositories. 

-------------------------------------------------


![Alt text](./project-structure.png "Repo structure at a glance")

The tutorials are divided into three parts for easier reading and these are in the following directories:

* ractor-tutorial-chapter-1 ([README](./README.chapter-1.md)).
* ractor-tutorial-chapter-2 ([README](./README.chapter-2.md)).
* ractor-tutorial-chapter-3 ([README](./README.chapter-3.md))

Each of these tutorial-chapters has its `cargo.toml` and `src` directories. The accompanying blog is inside README, as well as in the directory `accompanying_contents`.

In order to run the code, one needs to move to the corresponding directory and issue the command: `cargo run`.