Implement new Concept Exercise: error-handling

Open
#854 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
fsharp
Domain
content

Research direction

Read docs/concept-exercises.md, docs/rationale-for-v3.md, docs/features-of-v3.md, and languages/fsharp/reference/implementing-a-concept-exercise.md first. Use languages/fsharp/exercises/concept/numbers/.meta/design.md and .meta/config.json as references, then follow the implementation instructions. Done means the error-handling exercise is implemented for the stated learning objectives and requires no representer or analyzer changes.

Written by the indexing model from the issue text.

Description

x:action/create x:knowledge/intermediate x:module/concept-exercise x:size/large x:type/content

This issue describes how to implement the error-handling concept exercise for the F# 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:

Please also watch the following video:

Goal

The goal of this exercise is to teach the student the basics of the Concept of Error Handling in F#.

Learning objectives

  • Know when to use exceptions vs results vs options.
  • Know what railway oriented programming is.
  • Know how to use railway oriented programming, including custom operators.

Out of scope

  • Custom computation expression to deal with error-handling.
  • Custom operators to deal with error-handling applicatively (like <*>).
  • Converting error-handling to and from other types (like arrays of lists).

Concepts

The Concepts this exercise unlocks are:

  • error-handling: know when to use exceptions vs results vs options; know what railway oriented programming is; know how to use railway oriented programming, including custom operators.

Prerequisites

This exercise's prerequisites Concepts are:

  • options: know how to work with option values.
  • results: know how to work with result values.
  • exceptions: know how to work with exceptions.
  • operator-overloading: how to define custom operators.

Any data types used in this exercise (e.g. strings) should also be added as prerequisites.

Resources to refer to

Hints
After

Representer

This exercise does not require any specific representation logic to be added to the representer.

Analyzer

This exercise does not require any specific logic to be added to the analyzer.

Implementing

To implement this exercise, please follow these instructions.

Help

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

Dominant language
F#
Stars
118
Forks
113
Avg merge
2d 12h
Merged PRs (30d)
2

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from exercism/fsharp

All issues in exercism/fsharp

Similar issues

More Content issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.