From ea4645d09987431b4564b9a8131da4823108058f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Fernandes?= Date: Sun, 24 Mar 2024 09:12:20 -0300 Subject: [PATCH] [gleam] complete guessing-game --- gleam/guessing-game/.gitignore | 4 + gleam/guessing-game/HELP.md | 32 +++++ gleam/guessing-game/HINTS.md | 23 ++++ gleam/guessing-game/README.md | 115 ++++++++++++++++++ gleam/guessing-game/gleam.toml | 11 ++ gleam/guessing-game/manifest.toml | 26 ++++ gleam/guessing-game/src/guessing_game.gleam | 9 ++ .../test/guessing_game_test.gleam | 42 +++++++ 8 files changed, 262 insertions(+) create mode 100644 gleam/guessing-game/.gitignore create mode 100644 gleam/guessing-game/HELP.md create mode 100644 gleam/guessing-game/HINTS.md create mode 100644 gleam/guessing-game/README.md create mode 100644 gleam/guessing-game/gleam.toml create mode 100644 gleam/guessing-game/manifest.toml create mode 100644 gleam/guessing-game/src/guessing_game.gleam create mode 100644 gleam/guessing-game/test/guessing_game_test.gleam diff --git a/gleam/guessing-game/.gitignore b/gleam/guessing-game/.gitignore new file mode 100644 index 0000000..170cca9 --- /dev/null +++ b/gleam/guessing-game/.gitignore @@ -0,0 +1,4 @@ +*.beam +*.ez +build +erl_crash.dump diff --git a/gleam/guessing-game/HELP.md b/gleam/guessing-game/HELP.md new file mode 100644 index 0000000..f5d57be --- /dev/null +++ b/gleam/guessing-game/HELP.md @@ -0,0 +1,32 @@ +# Help + +## Running the tests + +To run the tests, run the command `gleam test` from within the exercise directory. + +## Submitting your solution + +You can submit your solution using the `exercism submit src/guessing_game.gleam` command. +This command will upload your solution to the Exercism website and print the solution page's URL. + +It's possible to submit an incomplete solution which allows you to: + +- See how others have completed the exercise +- Request help from a mentor + +## Need to get help? + +If you'd like help solving the exercise, check the following pages: + +- The [Gleam track's documentation](https://exercism.org/docs/tracks/gleam) +- The [Gleam track's programming category on the forum](https://forum.exercism.org/c/programming/gleam) +- [Exercism's programming category on the forum](https://forum.exercism.org/c/programming/5) +- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs) + +Should those resources not suffice, you could submit your (incomplete) solution to request mentoring. + +To get help if you're having trouble, you can use one of the following resources: + +- [gleam.run](https://gleam.run/documentation/) is the gleam official documentation. +- [Discord](https://discord.gg/Fm8Pwmy) is the discord channel. +- [StackOverflow](https://stackoverflow.com/questions/tagged/gleam) can be used to search for your problem and see if it has been answered already. You can also ask and answer questions. \ No newline at end of file diff --git a/gleam/guessing-game/HINTS.md b/gleam/guessing-game/HINTS.md new file mode 100644 index 0000000..aeb500f --- /dev/null +++ b/gleam/guessing-game/HINTS.md @@ -0,0 +1,23 @@ +# Hints + +## General + +- [This page][case-expressions] has a nice introduction to case expressions in Gleam. + +## 1. Reply to a correct guess + +- You can use a literal pattern to match on a specific number. + +## 2. Reply to a close guess + +- You can either use a literal pattern or a variable pattern and a guard. + +## 3. Reply to too low guesses + +- You can use a combination of a variable pattern and a guard. + +## 4. Reply to too high guesses + +- You can use a combination of a variable pattern and a guard, or a discard pattern. + +[case-expressions]: https://gleam.run/book/tour/case-expressions.html \ No newline at end of file diff --git a/gleam/guessing-game/README.md b/gleam/guessing-game/README.md new file mode 100644 index 0000000..8e2d49c --- /dev/null +++ b/gleam/guessing-game/README.md @@ -0,0 +1,115 @@ +# Guessing Game + +Welcome to Guessing Game on Exercism's Gleam Track. +If you need help running the tests or submitting your code, check out `HELP.md`. +If you get stuck on the exercise, check out `HINTS.md`, but try and solve it without using those first :) + +## Introduction + +## Case Expressions + +In Gleam a `case` expression can be used to conditionally execute code. With a case expression a value can be tested against one or more _patterns_. An example of such a pattern is the _literal pattern_, which matches a value against a literal value (e.g. `1` or `"hello"`). + +Case expressions are written with the `case` keyword: + +```gleam +pub fn describe(number: Int) -> String { + case number { + 0 -> "Zero" + 1 -> "One" + } +} +``` + +While this may look like `switch` statements in other languages, pattern matching starts to shine when also using other patterns. One such pattern is the _variable pattern_, which allows one to assign a value to a variable. In this example, the variable `i` will be assigned the value of `number` if it is not `0`: + +```gleam +pub fn describe(number: Int) -> String { + case number { + 0 -> "Zero" + i -> "Non zero" + } +} +``` + +In some cases, you may want to add an additional condition to a pattern. This is known as a _guard_ (clause), which can be added using the `if` keyword: + +```gleam +pub fn describe(number: Int) -> String { + case number { + 0 -> "Zero" + i if i < 0 -> "Negative number" + } +} +``` + +For performance reasons only basic mathematical and boolean operators are allowed in guards, other functions cannot be used in guards. + +In the above example, not all possible input will have a matching pattern. The compiler will detect this and output an error. This is known as _exhaustive checking_. To solve the warning, one has to handle all cases. For this, the _discard pattern_ can be used, which is a pattern that matches on any value: + +```gleam +pub fn describe(number: Int) -> String { + case number { + 0 -> "Zero" + i if i < 0 -> "Negative number" + _ -> "Positive number" + } +} + +// No compiler error +``` + +Case expressions will test a value against each pattern from top to bottom, until it finds a matching pattern and executes the logic associated with that pattern. The order of patterns matters! + +## Instructions + +In this exercise, you are playing a number guessing game with a friend. The rules are simple: you secretly choose a number between `1` and `100` and your friend tries to guess what number you've chosen. To help your friend, you respond differently depending on how close the guess was to the number you've chosen (`42`). These are the rules for the different replies: + +- If the guess is `42`: "Correct" +- If the guess is `41` or `43`: "So close" +- If the guess is less than `41`: "Too low" +- If the guess is greater than `43`: "Too high" + +You have four tasks to encode the replies to the guesses. + +## 1. Reply to a correct guess + +Implement the `reply` function to reply to a correct guess: + +```gleam +reply(42) +// -> "Correct" +``` + +## 2. Reply to a close guess + +Modify the `reply` function to reply to close guesses: + +```gleam +reply(41) +// -> "So close" +``` + +## 3. Reply to too low guesses + +Modify the `reply` function to reply to too low guesses: + +```gleam +reply(25) +// -> "Too low" +``` + +## 4. Reply to too high guesses + +Modify the `reply` function to reply to too high guesses: + +```gleam +reply(88) +// -> "Too high" +``` + +## Source + +### Created by + +- @lpil \ No newline at end of file diff --git a/gleam/guessing-game/gleam.toml b/gleam/guessing-game/gleam.toml new file mode 100644 index 0000000..fb34326 --- /dev/null +++ b/gleam/guessing-game/gleam.toml @@ -0,0 +1,11 @@ +name = "guessing_game" +version = "0.1.0" + +[dependencies] +gleam_bitwise = "~> 1.2" +gleam_otp = "~> 0.7 or ~> 1.0" +gleam_stdlib = "~> 0.32 or ~> 1.0" +simplifile = "~> 1.0" + +[dev-dependencies] +exercism_test_runner = "~> 1.4" diff --git a/gleam/guessing-game/manifest.toml b/gleam/guessing-game/manifest.toml new file mode 100644 index 0000000..002fb9f --- /dev/null +++ b/gleam/guessing-game/manifest.toml @@ -0,0 +1,26 @@ +# This file was generated by Gleam +# You typically do not need to edit this file + +packages = [ + { name = "argv", version = "1.0.1", build_tools = ["gleam"], requirements = [], otp_app = "argv", source = "hex", outer_checksum = "A6E9009E50BBE863EB37D963E4315398D41A3D87D0075480FC244125808F964A" }, + { name = "exercism_test_runner", version = "1.7.0", build_tools = ["gleam"], requirements = ["argv", "gap", "glance", "gleam_community_ansi", "gleam_erlang", "gleam_json", "gleam_stdlib", "simplifile"], otp_app = "exercism_test_runner", source = "hex", outer_checksum = "2FC1BADB19BEC2AE77BFD2D3A606A014C85412A7B874CAFC4BA8CF04B0B257CD" }, + { name = "gap", version = "1.1.0", build_tools = ["gleam"], requirements = ["gleam_community_ansi", "gleam_stdlib"], otp_app = "gap", source = "hex", outer_checksum = "2EE1B0A17E85CF73A0C1D29DA315A2699117A8F549C8E8D89FA8261BE41EDEB1" }, + { name = "glance", version = "0.8.2", build_tools = ["gleam"], requirements = ["gleam_stdlib", "glexer"], otp_app = "glance", source = "hex", outer_checksum = "ACF09457E8B564AD7A0D823DAFDD326F58263C01ACB0D432A9BEFDEDD1DA8E73" }, + { name = "gleam_bitwise", version = "1.3.1", build_tools = ["gleam"], requirements = [], otp_app = "gleam_bitwise", source = "hex", outer_checksum = "B36E1D3188D7F594C7FD4F43D0D2CE17561DE896202017548578B16FE1FE9EFC" }, + { name = "gleam_community_ansi", version = "1.4.0", build_tools = ["gleam"], requirements = ["gleam_community_colour", "gleam_stdlib"], otp_app = "gleam_community_ansi", source = "hex", outer_checksum = "FE79E08BF97009729259B6357EC058315B6FBB916FAD1C2FF9355115FEB0D3A4" }, + { name = "gleam_community_colour", version = "1.3.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_community_colour", source = "hex", outer_checksum = "A49A5E3AE8B637A5ACBA80ECB9B1AFE89FD3D5351FF6410A42B84F666D40D7D5" }, + { name = "gleam_erlang", version = "0.24.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_erlang", source = "hex", outer_checksum = "26BDB52E61889F56A291CB34167315780EE4AA20961917314446542C90D1C1A0" }, + { name = "gleam_json", version = "1.0.0", build_tools = ["gleam"], requirements = ["gleam_stdlib", "thoas"], otp_app = "gleam_json", source = "hex", outer_checksum = "8B197DD5D578EA6AC2C0D4BDC634C71A5BCA8E7DB5F47091C263ECB411A60DF3" }, + { name = "gleam_otp", version = "0.10.0", build_tools = ["gleam"], requirements = ["gleam_erlang", "gleam_stdlib"], otp_app = "gleam_otp", source = "hex", outer_checksum = "0B04FE915ACECE539B317F9652CAADBBC0F000184D586AAAF2D94C100945D72B" }, + { name = "gleam_stdlib", version = "0.36.0", build_tools = ["gleam"], requirements = [], otp_app = "gleam_stdlib", source = "hex", outer_checksum = "C0D14D807FEC6F8A08A7C9EF8DFDE6AE5C10E40E21325B2B29365965D82EB3D4" }, + { name = "glexer", version = "0.7.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "glexer", source = "hex", outer_checksum = "4484942A465482A0A100936E1E5F12314DB4B5AC0D87575A7B9E9062090B96BE" }, + { name = "simplifile", version = "1.5.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "simplifile", source = "hex", outer_checksum = "EB9AA8E65E5C1E3E0FDCFC81BC363FD433CB122D7D062750FFDF24DE4AC40116" }, + { name = "thoas", version = "0.4.1", build_tools = ["rebar3"], requirements = [], otp_app = "thoas", source = "hex", outer_checksum = "4918D50026C073C4AB1388437132C77A6F6F7C8AC43C60C13758CC0ADCE2134E" }, +] + +[requirements] +exercism_test_runner = { version = "~> 1.4" } +gleam_bitwise = { version = "~> 1.2" } +gleam_otp = { version = "~> 0.7 or ~> 1.0" } +gleam_stdlib = { version = "~> 0.32 or ~> 1.0" } +simplifile = { version = "~> 1.0" } diff --git a/gleam/guessing-game/src/guessing_game.gleam b/gleam/guessing-game/src/guessing_game.gleam new file mode 100644 index 0000000..8a77020 --- /dev/null +++ b/gleam/guessing-game/src/guessing_game.gleam @@ -0,0 +1,9 @@ +pub fn reply(guess: Int) -> String { + case guess { + _ if guess < 41 -> "Too low" + 41 -> "So close" + 42 -> "Correct" + 43 -> "So close" + _ -> "Too high" + } +} diff --git a/gleam/guessing-game/test/guessing_game_test.gleam b/gleam/guessing-game/test/guessing_game_test.gleam new file mode 100644 index 0000000..f759296 --- /dev/null +++ b/gleam/guessing-game/test/guessing_game_test.gleam @@ -0,0 +1,42 @@ +import exercism/should +import exercism/test_runner +import guessing_game + +pub fn main() { + test_runner.main() +} + +pub fn reply_42_test() { + guessing_game.reply(42) + |> should.equal("Correct") +} + +pub fn reply_41_test() { + guessing_game.reply(41) + |> should.equal("So close") +} + +pub fn reply_43_test() { + guessing_game.reply(43) + |> should.equal("So close") +} + +pub fn reply_40_test() { + guessing_game.reply(40) + |> should.equal("Too low") +} + +pub fn reply_1_test() { + guessing_game.reply(1) + |> should.equal("Too low") +} + +pub fn reply_44_test() { + guessing_game.reply(44) + |> should.equal("Too high") +} + +pub fn reply_100_test() { + guessing_game.reply(100) + |> should.equal("Too high") +}