Implement new Concept Exercise: methods

[ghost]

This issue describes how to implement the methods concept exercise for the Rust track.

Getting started

Please please please read the docs before starting. Posting PRs without reading these docs will be a lot more frustrating for you during the review cycle, and exhaust Exercism's maintainers' time. So, before diving into the implementation, please read up on the following documents:

• The features of v3.
• Rationale for v3.
• What are concept exercise and how they are structured?

Please also watch the following video:

• The Anatomy of a Concept Exercise.

Goal

The goal of this exercise is to teach the student how to use methods in Rust.

Learning objectives

• know what the impl keyword means
• know how to define methods on structs
• know how to read properties on an instance of a struct using &self
• know how to mutate properties on an instance of a struct using &mut self

Out of scope

• generic methods
• destructors

Concepts

• methods

Prerequisites

• basics
• structs-use
• explicit-return

Resources to refer to

Hints

• https://doc.rust-lang.org/stable/rust-by-example/fn/methods.html
• https://doc.rust-lang.org/book/ch05-03-method-syntax.html#defining-methods

After

• https://doc.rust-lang.org/stable/rust-by-example/fn/methods.html
• https://doc.rust-lang.org/book/ch05-03-method-syntax.html#defining-methods

Representer

No changes required

Analyzer

No changes required

Implementing

See our implementation guide for guidance. You may want to make use of boil_exercise.sh in the concept directory.

Help

If you have any questions while implementing the exercise, please post the questions as comments in this issue.

[ErikSchierboom]

@efx I've added the "Getting started" section (see this example) to the issue.

In a few minutes, I'll also be automatically adding the video reference (see exercism/v3#1227).

[ghost]

thanks @ErikSchierboom . I will make those updates to this issue later today.

[haraldreingruber]

Could it be that the health-statistics exercise is already covering this concept? Shall we link it with the methods concept?

[nahuakang]

I think @haraldreingruber's suggestion is valid since health-statistics seems like a perfect concept exercise for methods. My question is if we should write up the methods concept here?

@coriolinus I'll have to read up on how to create a concept directory and link an exercise to it but happy to claim this issue if no one has done/is doing work on it yet.

[coriolinus]

I wish that the structs concept required students to write at least one new struct on their own, and the methods concept required students to write at least one new method on their own. However, we can't let the perfect be the enemy of the good. It is more important to cover more concepts than to ensure that every concept exercise is flawless. I'll support adding methods to the concepts list for health-statistics.

Go ahead and claim the issue; I'm not aware of any competing work on it. Thanks for working on this!

[nahuakang]

@coriolinus Can you assign it to me? Can't really claim on issues :)

[nahuakang]

@coriolinus Just double-checking again that this is the link I need to create a new concept dir right? https://exercism.org/docs/building/tracks/concepts Thanks again :)

[coriolinus]

Yes, that's the correct documentation.