[New Exercise]: Line Up

config.json

@@ -614,6 +614,14 @@
         "practices": [],
         "prerequisites": [],
         "difficulty": 2
+      },
+            {
+        "slug": "line-up",
+        "name": "Line Up",
+        "uuid": "35d96adf-0fc2-4442-9299-76d880a70b3c",
+        "practices": [],
+        "prerequisites": [],
+        "difficulty": 2
       },
       {
         "slug": "error-handling",

exercises/practice/line-up/.docs/instructions.md

@@ -0,0 +1,19 @@
+# Instructions
+
+Given a name and a number, your task is to produce a sentence using that name and that number as an [ordinal numeral][ordinal-numeral].
+Yaʻqūb expects to use numbers from 1 up to 999.
+
+Rules:
+
+- Numbers ending in 1 (except for 11) → `"st"`
+- Numbers ending in 2 (except for 12) → `"nd"`
+- Numbers ending in 3 (except for 13) → `"rd"`
+- All other numbers → `"th"`
+
+Examples:
+
+- `"Mary", 1` → `"Mary, you are the 1st customer we serve today. Thank you!"`
+- `"John", 12` → `"John, you are the 12th customer we serve today. Thank you!"`
+- `"Dahir", 162` → `"Dahir, you are the 162nd customer we serve today. Thank you!"`
+
+[ordinal-numeral]: https://en.wikipedia.org/wiki/Ordinal_numeral

exercises/practice/line-up/.docs/introduction.md

@@ -0,0 +1,7 @@
+# Introduction
+
+Your friend Yaʻqūb works the counter at a deli in town, slicing, weighing, and wrapping orders for a line of hungry customers that gets longer every day.
+Waiting customers are starting to lose track of who is next, so he wants numbered tickets they can use to track the order in which they arrive.
+
+To make the customers feel special, he does not want the ticket to have only a number on it.
+They shall get a proper English sentence with their name and number on it.

exercises/practice/line-up/.meta/LineUp.example.ps1

@@ -0,0 +1,36 @@
+Function Get-LineUp() {
+    <#
+    .SYNOPSIS
+    Produce a greeting for customer in a line.
+
+    .DESCRIPTION
+    Given a name and a number, your task is to produce a sentence using that name and that number as an ordinal numeral.
+
+    .PARAMETER Name
+    String represents name of the customer.
+
+    .PARAMETER Number
+    Integer represents the order of the customer in line. (1 to 999)
+
+    .EXAMPLE
+    Get-LineUp -Name "Exercism" -Number 1
+    Returns: "Exercism, you are the 1st customer we serve today. Thank you!"
+    #>
+    [CmdletBinding()]
+    Param(
+        [string]$Name,
+        [int]$Number
+    )
+
+    $tens = $Number % 100
+    $ones = $Number % 10
+
+    $ordinal = switch ($true) {
+        { $tens -ge 11 -and $tens -le 13 } { 'th'; break }
+        { $ones -eq 1 } {'st'}
+        { $ones -eq 2 } {'nd'}
+        { $ones -eq 3 } {'rd'}
+        default { 'th' }
+    }
+    "$Name, you are the $Number$ordinal customer we serve today. Thank you!"
+}

exercises/practice/line-up/.meta/config.json

@@ -0,0 +1,19 @@
+{
+  "authors": [
+    "glaxxie"
+  ],
+  "files": {
+    "solution": [
+      "LineUp.ps1"
+    ],
+    "test": [
+      "LineUp.tests.ps1"
+    ],
+    "example": [
+      ".meta/LineUp.example.ps1"
+    ]
+  },
+  "blurb": "Help lining up customers at Yaʻqūb's Deli.",
+  "source": "mk-mxp, based on previous work from Exercism contributors codedge and neenjaw",
+  "source_url": "https://forum.exercism.org/t/new-exercise-ordinal-numbers/19147"
+}

exercises/practice/line-up/.meta/tests.toml

@@ -0,0 +1,67 @@
+# This is an auto-generated file.
+#
+# Regenerating this file via `configlet sync` will:
+# - Recreate every `description` key/value pair
+# - Recreate every `reimplements` key/value pair, where they exist in problem-specifications
+# - Remove any `include = true` key/value pair (an omitted `include` key implies inclusion)
+# - Preserve any other key/value pair
+#
+# As user-added comments (using the # character) will be removed when this file
+# is regenerated, comments can be added via a `comment` key.
+
+[7760d1b8-4864-4db4-953b-0fa7c047dbc0]
+description = "format smallest non-exceptional ordinal numeral 4"
+
+[e8b7c715-6baa-4f7b-8fb3-2fa48044ab7a]
+description = "format greatest single digit non-exceptional ordinal numeral 9"
+
+[f370aae9-7ae7-4247-90ce-e8ff8c6934df]
+description = "format non-exceptional ordinal numeral 5"
+
+[37f10dea-42a2-49de-bb92-0b690b677908]
+description = "format non-exceptional ordinal numeral 6"
+
+[d8dfb9a2-3a1f-4fee-9dae-01af3600054e]
+description = "format non-exceptional ordinal numeral 7"
+
+[505ec372-1803-42b1-9377-6934890fd055]
+description = "format non-exceptional ordinal numeral 8"
+
+[8267072d-be1f-4f70-b34a-76b7557a47b9]
+description = "format exceptional ordinal numeral 1"
+
+[4d8753cb-0364-4b29-84b8-4374a4fa2e3f]
+description = "format exceptional ordinal numeral 2"
+
+[8d44c223-3a7e-4f48-a0ca-78e67bf98aa7]
+description = "format exceptional ordinal numeral 3"
+
+[6c4f6c88-b306-4f40-bc78-97cdd583c21a]
+description = "format smallest two digit non-exceptional ordinal numeral 10"
+
+[e257a43f-d2b1-457a-97df-25f0923fc62a]
+description = "format non-exceptional ordinal numeral 11"
+
+[bb1db695-4d64-457f-81b8-4f5a2107e3f4]
+description = "format non-exceptional ordinal numeral 12"
+
+[60a3187c-9403-4835-97de-4f10ebfd63e2]
+description = "format non-exceptional ordinal numeral 13"
+
+[2bdcebc5-c029-4874-b6cc-e9bec80d603a]
+description = "format exceptional ordinal numeral 21"
+
+[74ee2317-0295-49d2-baf0-d56bcefa14e3]
+description = "format exceptional ordinal numeral 62"
+
+[b37c332d-7f68-40e3-8503-e43cbd67a0c4]
+description = "format exceptional ordinal numeral 100"
+
+[0375f250-ce92-4195-9555-00e28ccc4d99]
+description = "format exceptional ordinal numeral 101"
+
+[0d8a4974-9a8a-45a4-aca7-a9fb473c9836]
+description = "format non-exceptional ordinal numeral 112"
+
+[06b62efe-199e-4ce7-970d-4bf73945713f]
+description = "format exceptional ordinal numeral 123"

exercises/practice/line-up/LineUp.ps1

@@ -0,0 +1,25 @@
+Function Get-LineUp() {
+    <#
+    .SYNOPSIS
+    Produce a greeting for customer in a line.
+
+    .DESCRIPTION
+    Given a name and a number, your task is to produce a sentence using that name and that number as an ordinal numeral.
+
+    .PARAMETER Name
+    String represents name of the customer.
+
+    .PARAMETER Number
+    Integer represents the order of the customer in line. (1 to 999)
+
+    .EXAMPLE
+    Get-LineUp -Name "Exercism" -Number 1
+    Returns: "Exercism, you are the 1st customer we serve today. Thank you!"
+    #>
+    [CmdletBinding()]
+    Param(
+        [string]$Name,
+        [int]$Number
+    )
+    Throw "Please implement this function"
+}

exercises/practice/line-up/LineUp.tests.ps1

@@ -0,0 +1,138 @@
+BeforeAll {
+    . "./LineUp.ps1"
+}
+
+Describe "LineUp test cases" {
+    It "format smallest non-exceptional ordinal numeral 4" {
+        $got = Get-LineUp -Name "Gianna" -Number 4
+        $expect = "Gianna, you are the 4th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format greatest single digit non-exceptional ordinal numeral 9" {
+        $got = Get-LineUp -Name "Maarten" -Number 9
+        $expect = "Maarten, you are the 9th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 5" {
+        $got = Get-LineUp -Name "Petronila" -Number 5
+        $expect = "Petronila, you are the 5th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 6" {
+        $got = Get-LineUp -Name "Attakullakulla" -Number 6
+        $expect = "Attakullakulla, you are the 6th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 7" {
+        $got = Get-LineUp -Name "Kate" -Number 7
+        $expect = "Kate, you are the 7th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 8" {
+        $got = Get-LineUp -Name "Maximiliano" -Number 8
+        $expect = "Maximiliano, you are the 8th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 1" {
+        $got = Get-LineUp -Name "Mary" -Number 1
+        $expect = "Mary, you are the 1st customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 2" {
+        $got = Get-LineUp -Name "Haruto" -Number 2
+        $expect = "Haruto, you are the 2nd customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 3" {
+        $got = Get-LineUp -Name "Henriette" -Number 3
+        $expect = "Henriette, you are the 3rd customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format smallest two digit non-exceptional ordinal numeral 10" {
+        $got = Get-LineUp -Name "Alvarez" -Number 10
+        $expect = "Alvarez, you are the 10th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 11" {
+        $got = Get-LineUp -Name "Jacqueline" -Number 11
+        $expect = "Jacqueline, you are the 11th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 12" {
+        $got = Get-LineUp -Name "Juan" -Number 12
+        $expect = "Juan, you are the 12th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 13" {
+        $got = Get-LineUp -Name "Patricia" -Number 13
+        $expect = "Patricia, you are the 13th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 21" {
+        $got = Get-LineUp -Name "Washi" -Number 21
+        $expect = "Washi, you are the 21st customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 62" {
+        $got = Get-LineUp -Name "Nayra" -Number 62
+        $expect = "Nayra, you are the 62nd customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 100" {
+        $got = Get-LineUp -Name "John" -Number 100
+        $expect = "John, you are the 100th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 101" {
+        $got = Get-LineUp -Name "Zeinab" -Number 101
+        $expect = "Zeinab, you are the 101st customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format non-exceptional ordinal numeral 112" {
+        $got = Get-LineUp -Name "Knud" -Number 112
+        $expect = "Knud, you are the 112th customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+
+    It "format exceptional ordinal numeral 123" {
+        $got = Get-LineUp -Name "Yma" -Number 123
+        $expect = "Yma, you are the 123rd customer we serve today. Thank you!"
+
+        $got | Should -BeExactly $expect
+    }
+}