Skip to content

Add new practice exercise split-second-stopwatch #749

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions config.json
Original file line number Diff line number Diff line change
Expand Up @@ -1543,6 +1543,24 @@
"comparison"
],
"difficulty": 7
},
{
"slug": "split-second-stopwatch",
"name": "Split-Second Stopwatch",
"uuid": "0945769a-6e67-409d-9f11-102112fb8be9",
"practices": [
"opaque-types"
],
"prerequisites": [
"opaque-types",
"custom-types",
"pattern-matching",
"strings",
"lists",
"result",
"records"
],
"difficulty": 4
}
],
"foregone": [
Expand Down
22 changes: 22 additions & 0 deletions exercises/practice/split-second-stopwatch/.docs/instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Instructions

Your task is to build a stopwatch to keep precise track of lap times.

The stopwatch uses four commands (start, stop, lap, and reset) to keep track of:

1. The current lap's tracked time
2. Previously recorded lap times

What commands can be used depends on which state the stopwatch is in:

1. Ready: initial state
2. Running: tracking time
3. Stopped: not tracking time

| Command | Begin state | End state | Effect |
| ------- | ----------- | --------- | -------------------------------------------------------- |
| Start | Ready | Running | Start tracking time |
| Start | Stopped | Running | Resume tracking time |
| Stop | Running | Stopped | Stop tracking time |
| Lap | Running | Running | Add current lap to previous laps, then reset current lap |
| Reset | Stopped | Ready | Reset current lap and clear previous laps |
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Introduction

You've always run for the thrill of it — no schedules, no timers, just the sound of your feet on the pavement.
But now that you've joined a competitive running crew, things are getting serious.
Training sessions are timed to the second, and every split second counts.
To keep pace, you've picked up the _Split-Second Stopwatch_ — a sleek, high-tech gadget that's about to become your new best friend.
19 changes: 19 additions & 0 deletions exercises/practice/split-second-stopwatch/.meta/config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"authors": [
"jiegillet"
],
"files": {
"solution": [
"src/SplitSecondStopwatch.elm"
],
"test": [
"tests/Tests.elm"
],
"example": [
".meta/src/SplitSecondStopwatch.example.elm"
]
},
"blurb": "Keep track of time through a digital stopwatch.",
"source": "Erik Schierboom",
"source_url": "https://github.com/exercism/problem-specifications/pull/2547"
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
module SplitSecondStopwatch exposing
( State(..)
, Stopwatch
, advanceTime
, currentLap
, lap
, new
, previousLaps
, reset
, start
, state
, stop
, total
)


type State
= Ready
| Running
| Stopped


type Stopwatch
= Stopwatch
{ state_ : State
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what are the underscores for?

, currentLap_ : Int
, previousLaps_ : List Int
}


new : Stopwatch
new =
Stopwatch { state_ = Ready, currentLap_ = 0, previousLaps_ = [] }


state : Stopwatch -> State
state (Stopwatch { state_ }) =
state_


currentLap : Stopwatch -> String
currentLap (Stopwatch { currentLap_ }) =
formatTime currentLap_


previousLaps : Stopwatch -> List String
previousLaps (Stopwatch { previousLaps_ }) =
previousLaps_
|> List.reverse
|> List.map formatTime


advanceTime : String -> Stopwatch -> Stopwatch
advanceTime time (Stopwatch ({ state_, currentLap_ } as stopwatch)) =
case state_ of
Running ->
Stopwatch { stopwatch | currentLap_ = currentLap_ + parseTime time }

_ ->
Stopwatch stopwatch


total : Stopwatch -> String
total (Stopwatch { currentLap_, previousLaps_ }) =
(currentLap_ :: previousLaps_)
|> List.sum
|> formatTime


start : Stopwatch -> Result String Stopwatch
start (Stopwatch ({ state_ } as stopwatch)) =
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we could use a finite state machine here, instead of using Result (and in the other places)?

case state_ of
Running ->
Err "cannot start an already running stopwatch"

_ ->
Ok (Stopwatch { stopwatch | state_ = Running })


stop : Stopwatch -> Result String Stopwatch
stop (Stopwatch ({ state_ } as stopwatch)) =
case state_ of
Running ->
Ok (Stopwatch { stopwatch | state_ = Stopped })

_ ->
Err "cannot stop a stopwatch that is not running"


lap : Stopwatch -> Result String Stopwatch
lap (Stopwatch ({ state_, currentLap_, previousLaps_ } as stopwatch)) =
case state_ of
Running ->
Ok (Stopwatch { stopwatch | currentLap_ = 0, previousLaps_ = currentLap_ :: previousLaps_ })

_ ->
Err "cannot lap a stopwatch that is not running"


reset : Stopwatch -> Result String Stopwatch
reset (Stopwatch { state_ }) =
case state_ of
Stopped ->
Ok new

_ ->
Err "cannot reset a stopwatch that is not stopped"


parseTime : String -> Int
parseTime time =
let
timeValues =
time
|> String.split ":"
|> List.filterMap String.toInt
in
case timeValues of
[ hours, minutes, seconds ] ->
hours * 3600 + minutes * 60 + seconds

_ ->
0


formatTime : Int -> String
formatTime time =
let
hours =
time // 3600

minutes =
modBy 3600 time // 60

seconds =
modBy 60 time
in
[ hours, minutes, seconds ]
|> List.map String.fromInt
|> List.map (String.padLeft 2 '0')
|> String.join ":"
97 changes: 97 additions & 0 deletions exercises/practice/split-second-stopwatch/.meta/tests.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
# 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.

[ddb238ea-99d4-4eaa-a81d-3c917a525a23]
description = "new stopwatch starts in ready state"

[b19635d4-08ad-4ac3-b87f-aca10e844071]
description = "new stopwatch's current lap has no elapsed time"

[492eb532-268d-43ea-8a19-2a032067d335]
description = "new stopwatch's total has no elapsed time"

[8a892c1e-9ef7-4690-894e-e155a1fe4484]
description = "new stopwatch does not have previous laps"

[5b2705b6-a584-4042-ba3a-4ab8d0ab0281]
description = "start from ready state changes state to running"

[748235ce-1109-440b-9898-0a431ea179b6]
description = "start does not change previous laps"

[491487b1-593d-423e-a075-aa78d449ff1f]
description = "start initiates time tracking for current lap"

[a0a7ba2c-8db6-412c-b1b6-cb890e9b72ed]
description = "start initiates time tracking for total"

[7f558a17-ef6d-4a5b-803a-f313af7c41d3]
description = "start cannot be called from running state"

[32466eef-b2be-4d60-a927-e24fce52dab9]
description = "stop from running state changes state to stopped"

[621eac4c-8f43-4d99-919c-4cad776d93df]
description = "stop pauses time tracking for current lap"

[465bcc82-7643-41f2-97ff-5e817cef8db4]
description = "stop pauses time tracking for total"

[b1ba7454-d627-41ee-a078-891b2ed266fc]
description = "stop cannot be called from ready state"

[5c041078-0898-44dc-9d5b-8ebb5352626c]
description = "stop cannot be called from stopped state"

[3f32171d-8fbf-46b6-bc2b-0810e1ec53b7]
description = "start from stopped state changes state to running"

[626997cb-78d5-4fe8-b501-29fdef804799]
description = "start from stopped state resumes time tracking for current lap"

[58487c53-ab26-471c-a171-807ef6363319]
description = "start from stopped state resumes time tracking for total"

[091966e3-ed25-4397-908b-8bb0330118f8]
description = "lap adds current lap to previous laps"

[1aa4c5ee-a7d5-4d59-9679-419deef3c88f]
description = "lap resets current lap and resumes time tracking"

[4b46b92e-1b3f-46f6-97d2-0082caf56e80]
description = "lap continues time tracking for total"

[ea75d36e-63eb-4f34-97ce-8c70e620bdba]
description = "lap cannot be called from ready state"

[63731154-a23a-412d-a13f-c562f208eb1e]
description = "lap cannot be called from stopped state"

[e585ee15-3b3f-4785-976b-dd96e7cc978b]
description = "stop does not change previous laps"

[fc3645e2-86cf-4d11-97c6-489f031103f6]
description = "reset from stopped state changes state to ready"

[20fbfbf7-68ad-4310-975a-f5f132886c4e]
description = "reset resets current lap"

[00a8f7bb-dd5c-43e5-8705-3ef124007662]
description = "reset clears previous laps"

[76cea936-6214-4e95-b6d1-4d4edcf90499]
description = "reset cannot be called from ready state"

[ba4d8e69-f200-4721-b59e-90d8cf615153]
description = "reset cannot be called from running state"

[0b01751a-cb57-493f-bb86-409de6e84306]
description = "supports very long laps"
29 changes: 29 additions & 0 deletions exercises/practice/split-second-stopwatch/elm.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"type": "application",
"source-directories": [
"src"
],
"elm-version": "0.19.1",
"dependencies": {
"direct": {
"elm/core": "1.0.5",
"elm/json": "1.1.3",
"elm/parser": "1.1.0",
"elm/random": "1.0.0",
"elm/regex": "1.0.0",
"elm/time": "1.0.0",
"elm/html": "1.0.0"
},
"indirect": {}
},
"test-dependencies": {
"direct": {
"elm-explorations/test": "2.1.0",
"rtfeldman/elm-iso8601-date-strings": "1.1.4"
},
"indirect": {
"elm/bytes": "1.0.8",
"elm/virtual-dom": "1.0.3"
}
}
}
Loading