public/subjects/mobs/README.md

mobs

Instructions

Create a module named mobs, containing a structure Mob which has:

• name: String
• boss: Boss
• members: a vector of Member
• cities: a vector of tuples containing a city name and a u8
• wealth: u32
• recruit: an associated function which adds a Member to the members vector. It should accept a name, and an age. The member's role should be set to Associate.
• attack: an associated function which receives another Mob. It will remove the last member from the vector of Member from whichever mob has the least power combat score. In the case of a draw, the attacker loses. In the case that one of the mobs is left with zero members, the victorious mob will also take the cities and wealth from the losing mob. The power combat score is calculated from the sum of the role of each mob member:
  • Underboss: 4
  • Caporegime: 3
  • Soldier: 2
  • Associate: 1
• steal: an associated function which receives a Mob to target, and a u32 value to steal. The 'self' mob steals the value from the wealth of the target mob, and adds the value to its own wealth. Only as much money as the target mob has can be stolen.
• conquer_city: an associated function which receives a vector of Mob, a city name and a u8 value. The city name and u8 value are added to its list of cities if non of the other mobs in the vector have a city with the same name.

You will also need to create two submodules of mob:

• boss: which should contain:
  • Boss: a struct which consists of:
  • name: String
  • age: u8
  • new: an associated function which accepts a name and age, and returns a Boss.
• member submodule which consists of:
  • Role: an enum with the variants:
    • Underboss
    • Caporegime
    • Soldier
    • Associate
  • Member: a struct which consists of:
    • name: String
    • role: Role
    • age: u8
    • get_promotion: an associated function which when invoked should promote the member from:
      • Associate -> Soldier
      • Soldier -> Caporegime
      • Caporegime -> Underboss
    • new: accepts a name, role and age, returning a Member.

The submodules should be created inside a folder named mobs. We advise you to create two files for each submodule, but that is up to you.

You must include #[derive(Debug, Clone, PartialEq)] above every struct and enum.

Expected Function

You'll need to work out the function signatures for yourself.

Usage

Here is a program to test your function:

use mobs::*;

fn main() {
  let (mafia1, mafia2) = (
    Mob {
      name: "Hairy Giants".to_string(),
      boss: boss::Boss::new("Louie HaHa", 36),
      cities: vec![("San Francisco".to_string(), 7)],
      members: vec![
        member::Member::new("Benny Eggs", member::Role::Soldier, 28),
        member::Member::new("Jhonny", member::Role::Associate, 17),
        member::Member::new("Greasy Thumb", member::Role::Soldier, 30),
        member::Member::new("No Finger", member::Role::Caporegime, 32),
      ],
      wealth: 100000,
    },
    Mob {
      name: "Red Thorns".to_string(),
      boss: boss::Boss::new("Big Tuna", 30),
      cities: vec![("San Jose".to_string(), 5)],
      members: vec![
        member::Member::new("Knuckles", member::Role::Soldier, 25),
        member::Member::new("Baldy Dom", member::Role::Caporegime, 36),
        member::Member::new("Crazy Joe", member::Role::Underboss, 23),
      ],
      wealth: 70000,
    },
  );

  println!("{:?}\n{:?}", mafia1, mafia2);
}

And its output:

$ cargo run
Mob { name: "Hairy Giants", boss: Boss { name: "Louie HaHa", age: 36 }, members: [Member { name: "Benny Eggs", role: Soldier, age: 28 }, Member { name: "Jhonny", role: Associate, age: 17 }, Member { name: "Greasy Thumb", role: Soldier, age: 30 }, Member { name: "No Finger", role: Caporegime, age: 32 }], cities: [("San Francisco", 7)], wealth: 100000 }
Mob { name: "Red Thorns", boss: Boss { name: "Big Tuna", age: 30 }, members: [Member { name: "Knuckles", role: Soldier, age: 25 }, Member { name: "Baldy Dom", role: Caporegime, age: 36 }, Member { name: "Crazy Joe", role: Underboss, age: 23 }], cities: [("San Jose", 5)], wealth: 70000 }
$

Notions

• Packages, Crates and Modules