diff --git a/secrets/.exercism/config.json b/secrets/.exercism/config.json new file mode 100644 index 0000000..d3b4d2b --- /dev/null +++ b/secrets/.exercism/config.json @@ -0,0 +1,24 @@ +{ + "authors": [ + "lpil" + ], + "files": { + "solution": [ + "src/secrets.gleam" + ], + "test": [ + "test/secrets_test.gleam" + ], + "exemplar": [ + ".meta/example.gleam" + ], + "invalidator": [ + "gleam.toml", + "manifest.toml" + ] + }, + "forked_from": [ + "elixir/secrets" + ], + "blurb": "Learn about anonymous functions by writing the software for an encryption device." +} diff --git a/secrets/.exercism/metadata.json b/secrets/.exercism/metadata.json new file mode 100644 index 0000000..e2621dc --- /dev/null +++ b/secrets/.exercism/metadata.json @@ -0,0 +1 @@ +{"track":"gleam","exercise":"secrets","id":"78c062ca9cf549bea291e52f89974933","url":"https://exercism.org/tracks/gleam/exercises/secrets","handle":"fw353qwgs","is_requester":true,"auto_approve":false} \ No newline at end of file diff --git a/secrets/.gitignore b/secrets/.gitignore new file mode 100644 index 0000000..170cca9 --- /dev/null +++ b/secrets/.gitignore @@ -0,0 +1,4 @@ +*.beam +*.ez +build +erl_crash.dump diff --git a/secrets/HELP.md b/secrets/HELP.md new file mode 100644 index 0000000..952fb1c --- /dev/null +++ b/secrets/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/secrets.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/secrets/HINTS.md b/secrets/HINTS.md new file mode 100644 index 0000000..443c092 --- /dev/null +++ b/secrets/HINTS.md @@ -0,0 +1,26 @@ +# Hints + +## General + +- Make use of anonymous functions. +- Anonymous functions can reference variables in scope when they were defined. + +## 1. Create an adder + +- Return an anonymous function which adds the argument from the anonymous function to the argument passed in to `secret_add`. + +## 2. Create a subtractor + +- Return an anonymous function which subtracts the argument passed in to `secret_subtract` from the argument from the anonymous function. + +## 3. Create a multiplier + +- Return an anonymous function which multiplies the argument from the anonymous function to the argument passed in to `secret_multiply`. + +## 4. Create a divider + +- Return an anonymous function which divides the argument from the anonymous function by the argument passed in to `secret_divide`. + +## 5. Create a function combiner + +- Return an anonymous function which each of the functions passed in to `secret_combine`. \ No newline at end of file diff --git a/secrets/README.md b/secrets/README.md new file mode 100644 index 0000000..2c3abd6 --- /dev/null +++ b/secrets/README.md @@ -0,0 +1,129 @@ +# Secrets + +Welcome to Secrets 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 + +## Anonymous Functions + +Gleam has first class functions, meaning functions are normal values that can be assigned to variables, passed as arguments, and returned from other functions. + +A named function defined in a module can be referenced by its name. + +```gleam +pub fn main() { + // Assign the function to a variable + let f = add_one + + // Invoke the function + f(1) // -> 2 + f(2) // -> 3 +} + +fn add_one(x) { + x + 1 +} +``` + +Gleam also has anonymous functions, which are defined within other functions. + +```gleam +// Define the function +let f = fn(x) { x + 1 } + +// Invoke the function +f(1) // -> 2 +f(2) // -> 3 +``` + +The type of a function is written using a similar syntax to anonymous functions. The type of a function that takes an `Int` and a `Float` and returns an `Int` is written like this: + +```gleam +fn(Int, Float) -> Int +``` + +Anonymous functions can reference variables that were in scope when they were defined, making them _closures_. + +```gleam +let secret_number = 42 + +// This function always returns 42 +fn() { secret_number } +``` + +The _function capture_ syntax provides a convenient shorthand for creating anonymous functions that pass a single argument to a function. These two expressions are equivalent: + +```gleam +// Anonymous function syntax +let f = fn(x) { my_function(1, 2, x) } + +// Function capture syntax +let f = my_function(1, 2, _) +``` + +## Instructions + +In this exercise, you've been tasked with writing the software for an encryption device that works by performing transformations on data. You need a way to flexibly create complicated functions by combining simpler functions together. + +For each task, return an anonymous function that can be invoked from the calling scope. + +## 1. Create an adder + +Implement `secret_add`. It should return a function which takes one argument and adds to it the argument passed in to `secret_add`. + +```gleam +let adder = secret_add(2) +adder(2) +// -> 4 +``` + +## 2. Create a subtractor + +Implement `secret_subtract`. It should return a function which takes one argument and subtracts the secret passed in to `secret_subtract` from that argument. + +```gleam +let subtractor = secret_subtract(2) +subtractor(3) +// -> 1 +``` + +## 3. Create a multiplier + +Implement `secret_multiply`. It should return a function which takes one argument and multiplies it by the secret passed in to `secret_multiply`. + +```gleam +let multiplier = secret_multiply(7) +multiplier(3) +// -> 21 +``` + +## 4. Create a divider + +Implement `secret_divide`. It should return a function which takes one argument and divides it by the secret passed in to `secret_divide`. + +```gleam +let divider = secret_divide(3) +divider(32) +// -> 10 +``` + +## 5. Create a function combiner + +Implement `secret_combine`. It should return a function which takes one argument and applies to it the two functions passed in to `secret_combine` in order. + +```gleam +let multiply = secret_multiply(7) +let divide = secret_divide(3) +let combined = secret_combine(multiply, divide) + +combined(6) +// -> 14 +``` + +## Source + +### Created by + +- @lpil \ No newline at end of file diff --git a/secrets/gleam.toml b/secrets/gleam.toml new file mode 100644 index 0000000..2efa12f --- /dev/null +++ b/secrets/gleam.toml @@ -0,0 +1,14 @@ +name = "secrets" +version = "0.1.0" + +[dependencies] +gleam_otp = "~> 0.7 or ~> 1.0" +gleam_stdlib = ">= 0.54.0 or ~> 1.0" +simplifile = "~> 1.0" +gleam_erlang = ">= 0.25.0 and < 1.0.0" +gleam_yielder = ">= 1.1.0 and < 2.0.0" +gleam_regexp = ">= 1.1.0 and < 2.0.0" +gleam_deque = ">= 1.0.0 and < 2.0.0" + +[dev-dependencies] +exercism_test_runner = "~> 1.9" diff --git a/secrets/manifest.toml b/secrets/manifest.toml new file mode 100644 index 0000000..7b32e9a --- /dev/null +++ b/secrets/manifest.toml @@ -0,0 +1,31 @@ +# This file was generated by Gleam +# You typically do not need to edit this file + +packages = [ + { name = "argv", version = "1.0.2", build_tools = ["gleam"], requirements = [], otp_app = "argv", source = "hex", outer_checksum = "BA1FF0929525DEBA1CE67256E5ADF77A7CDDFE729E3E3F57A5BDCAA031DED09D" }, + { name = "exercism_test_runner", version = "1.9.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 = "0B17BB25F2FF1E60266467C24FE0CA04005410306AA05E9A4B41B1852D72865C" }, + { name = "filepath", version = "1.1.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "filepath", source = "hex", outer_checksum = "67A6D15FB39EEB69DD31F8C145BB5A421790581BD6AA14B33D64D5A55DBD6587" }, + { name = "gap", version = "1.1.3", build_tools = ["gleam"], requirements = ["gleam_community_ansi", "gleam_stdlib"], otp_app = "gap", source = "hex", outer_checksum = "6EF5E3B523FDFBC317E9EA28D5163EE04744A97C007106F90207569789612291" }, + { name = "glance", version = "1.1.0", build_tools = ["gleam"], requirements = ["gleam_stdlib", "glexer"], otp_app = "glance", source = "hex", outer_checksum = "E155BA1A787FD11827048355021C0390D2FE9A518485526F631A9D472858CC6D" }, + { name = "gleam_community_ansi", version = "1.4.3", build_tools = ["gleam"], requirements = ["gleam_community_colour", "gleam_regexp", "gleam_stdlib"], otp_app = "gleam_community_ansi", source = "hex", outer_checksum = "8A62AE9CC6EA65BEA630D95016D6C07E4F9973565FA3D0DE68DC4200D8E0DD27" }, + { name = "gleam_community_colour", version = "2.0.0", build_tools = ["gleam"], requirements = ["gleam_json", "gleam_stdlib"], otp_app = "gleam_community_colour", source = "hex", outer_checksum = "FDD6AC62C6EC8506C005949A4FCEF032038191D5EAAEC3C9A203CD53AE956ACA" }, + { name = "gleam_deque", version = "1.0.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_deque", source = "hex", outer_checksum = "64D77068931338CF0D0CB5D37522C3E3CCA7CB7D6C5BACB41648B519CC0133C7" }, + { name = "gleam_erlang", version = "0.34.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_erlang", source = "hex", outer_checksum = "0C38F2A128BAA0CEF17C3000BD2097EB80634E239CE31A86400C4416A5D0FDCC" }, + { name = "gleam_json", version = "2.3.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_json", source = "hex", outer_checksum = "C55C5C2B318533A8072D221C5E06E5A75711C129E420DD1CE463342106012E5D" }, + { name = "gleam_otp", version = "0.16.1", build_tools = ["gleam"], requirements = ["gleam_erlang", "gleam_stdlib"], otp_app = "gleam_otp", source = "hex", outer_checksum = "50DA1539FC8E8FA09924EB36A67A2BBB0AD6B27BCDED5A7EF627057CF69D035E" }, + { name = "gleam_regexp", version = "1.1.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_regexp", source = "hex", outer_checksum = "7F5E0C0BBEB3C58E57C9CB05FA9002F970C85AD4A63BA1E55CBCB35C15809179" }, + { name = "gleam_stdlib", version = "0.55.0", build_tools = ["gleam"], requirements = [], otp_app = "gleam_stdlib", source = "hex", outer_checksum = "32D8F4AE03771516950047813A9E359249BD9FBA5C33463FDB7B953D6F8E896B" }, + { name = "gleam_yielder", version = "1.1.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_yielder", source = "hex", outer_checksum = "8E4E4ECFA7982859F430C57F549200C7749823C106759F4A19A78AEA6687717A" }, + { name = "glexer", version = "2.2.1", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "glexer", source = "hex", outer_checksum = "5C235CBDF4DA5203AD5EAB1D6D8B456ED8162C5424FE2309CFFB7EF438B7C269" }, + { name = "simplifile", version = "1.7.0", build_tools = ["gleam"], requirements = ["filepath", "gleam_stdlib"], otp_app = "simplifile", source = "hex", outer_checksum = "1D5DFA3A2F9319EC85825F6ED88B8E449F381B0D55A62F5E61424E748E7DDEB0" }, +] + +[requirements] +exercism_test_runner = { version = "~> 1.9" } +gleam_deque = { version = ">= 1.0.0 and < 2.0.0" } +gleam_erlang = { version = ">= 0.25.0 and < 1.0.0" } +gleam_otp = { version = "~> 0.7 or ~> 1.0" } +gleam_regexp = { version = ">= 1.1.0 and < 2.0.0" } +gleam_stdlib = { version = ">= 0.54.0 or ~> 1.0" } +gleam_yielder = { version = ">= 1.1.0 and < 2.0.0" } +simplifile = { version = "~> 1.0" } diff --git a/secrets/src/secrets.gleam b/secrets/src/secrets.gleam new file mode 100644 index 0000000..381f280 --- /dev/null +++ b/secrets/src/secrets.gleam @@ -0,0 +1,22 @@ +pub fn secret_add(secret: Int) -> fn(Int) -> Int { + fn(n: Int) { n + secret } +} + +pub fn secret_subtract(secret: Int) -> fn(Int) -> Int { + fn(n: Int) { n - secret } +} + +pub fn secret_multiply(secret: Int) -> fn(Int) -> Int { + fn(n: Int) { n * secret } +} + +pub fn secret_divide(secret: Int) -> fn(Int) -> Int { + fn(n: Int) { n / secret } +} + +pub fn secret_combine( + secret_function1: fn(Int) -> Int, + secret_function2: fn(Int) -> Int, +) -> fn(Int) -> Int { + fn(n: Int) { secret_function2(secret_function1(n)) } +} diff --git a/secrets/test/secrets_test.gleam b/secrets/test/secrets_test.gleam new file mode 100644 index 0000000..560898a --- /dev/null +++ b/secrets/test/secrets_test.gleam @@ -0,0 +1,127 @@ +import exercism/should +import exercism/test_runner +import secrets + +pub fn main() { + test_runner.main() +} + +pub fn add_3_test() { + let add = secrets.secret_add(3) + should.equal(6, add(3)) +} + +pub fn add_6_test() { + let add = secrets.secret_add(6) + should.equal(15, add(9)) +} + +pub fn subtract_3_test() { + let subtract = secrets.secret_subtract(3) + should.equal(3, subtract(6)) +} + +pub fn subtract_6_test() { + let subtract = secrets.secret_subtract(6) + should.equal(-3, subtract(3)) +} + +pub fn multiply_by_3_test() { + let multiply = secrets.secret_multiply(3) + should.equal(18, multiply(6)) +} + +pub fn multiply_by_6_test() { + let multiply = secrets.secret_multiply(6) + should.equal(42, multiply(7)) +} + +pub fn divide_by_3_test() { + let divide = secrets.secret_divide(3) + should.equal(2, divide(6)) +} + +pub fn divide_by_6_test() { + let divide = secrets.secret_divide(6) + should.equal(1, divide(7)) +} + +pub fn combine_5_add_10_then_subtract_5_test() { + let f = secrets.secret_add(10) + let g = secrets.secret_subtract(5) + let h = secrets.secret_combine(f, g) + + should.equal(10, h(5)) +} + +pub fn combine_100_multiply_by_2_then_subtract_20_test() { + let f = secrets.secret_multiply(2) + let g = secrets.secret_subtract(20) + let h = secrets.secret_combine(f, g) + + should.equal(180, h(100)) +} + +pub fn combine_100_divide_by_10_then_add_10_test() { + let f = secrets.secret_divide(10) + let g = secrets.secret_add(10) + let h = secrets.secret_combine(f, g) + + should.equal(20, h(100)) +} + +pub fn combine_32_divide_by_3_then_add_5_test() { + let f = secrets.secret_divide(3) + let g = secrets.secret_add(5) + let h = secrets.secret_combine(f, g) + + should.equal(15, h(32)) +} + +pub fn combine_7_multiply_3_then_add_5_test() { + let f = secrets.secret_multiply(3) + let g = secrets.secret_add(5) + let h = secrets.secret_combine(f, g) + + should.equal(26, h(7)) +} + +pub fn combine_7_multiply_7_then_multiply_7_test() { + let f = secrets.secret_multiply(7) + let g = secrets.secret_multiply(7) + let h = secrets.secret_combine(f, g) + + should.equal(343, h(7)) +} + +pub fn combine_4_divide_1_then_divide_2_test() { + let f = secrets.secret_divide(1) + let g = secrets.secret_divide(2) + let h = secrets.secret_combine(f, g) + + should.equal(2, h(4)) +} + +pub fn combine_7_divide_7_then_divide_7_test() { + let f = secrets.secret_divide(7) + let g = secrets.secret_divide(7) + let h = secrets.secret_combine(f, g) + + should.equal(0, h(7)) +} + +pub fn combine_4_add_3_then_divide_7_test() { + let f = secrets.secret_add(3) + let g = secrets.secret_divide(7) + let h = secrets.secret_combine(f, g) + + should.equal(1, h(4)) +} + +pub fn combine_81_divide_by_9_then_multiply_7_test() { + let f = secrets.secret_divide(9) + let g = secrets.secret_multiply(7) + let h = secrets.secret_combine(f, g) + + should.equal(63, h(81)) +}