Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/protoship/learn-reasonml-workshop
Learn ReasonML with 24 exercises. No prior functional programming knowledge required.
https://github.com/protoship/learn-reasonml-workshop
ocaml reasonml
Last synced: about 2 hours ago
JSON representation
Learn ReasonML with 24 exercises. No prior functional programming knowledge required.
- Host: GitHub
- URL: https://github.com/protoship/learn-reasonml-workshop
- Owner: protoship
- License: apache-2.0
- Created: 2018-04-23T11:29:21.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-05T06:21:32.000Z (12 months ago)
- Last Synced: 2025-01-14T19:36:18.316Z (7 days ago)
- Topics: ocaml, reasonml
- Language: Reason
- Homepage:
- Size: 159 KB
- Stars: 269
- Watchers: 6
- Forks: 45
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Introduction
Reason is a language that looks and reads like Javascript, writes like Javascript, and even interops nicely with Javascript. But it is in fact a new syntax for OCaml, a powerful statically typed functional programming language.
The syntax makes ReasonML easy to start playing with, but unless you already know a typed functional language, you will soon run into stumbling blocks because of unfamiliarity with static types and functional programming.
Fear not! Work through these exercises and learn all the basics - defining and using functions, understanding recursion, lists, list operations, variants, and all the way till mutable variables. They will give you a great foundation to start mastering this beautiful language.
# Credits
These exercises are originally from [a workshop organized by Jane Street](https://blog.janestreet.com/learn-ocaml-nyc/) for teaching `OCaml` to programmers who work in other languages and who do not necessarily have experience with functional languages. [Link to the original repo](https://github.com/janestreet/learn-ocaml-workshop). We adapted the tutorials and exercise code to the Reason syntax and toolchain.
# Setting Up
1. Setup your editor. We recommend `VSCode` along with the [vscode-reasonml](https://github.com/reasonml-editor/vscode-reasonml) extension. If you prefer a different editor check the instructions for [other supported editors](https://reasonml.github.io/docs/en/editor-plugins.html)
2. Clone this repository, and run `npm install`.
# Workflow
The exercises are numerically ordered and can be found in the `src/exercises` directory.
Start by opening the first exercise in a text editor - `src/exercises/01-introduction/introduction.re`. It will tell you where to go from there.
All exercises except the first one comes with a test. Run them as you complete each exercise. For example for the second exercise, run its test with:
```
node src/exercises/02-basic_types/basicTypes.bs.js
```
This `.bs.js` file is your Reason program (`.re`) compiled to Javascript. `.bs` stands for the [bucklescript compiler](https://bucklescript.github.io/). The `.bs.js` code is readable Javascript - give them a look if you're curious!
You can also run `./run_tests` which will run all the tests automatically for you and stop at the first failing one.
# Support
Please feel free to raise an issue if you have any questions as you work through the exercises. You can also find help in the [Reason Discord channel](https://discord.gg/reasonml), or in the [Reason Discourse forum](https://reasonml.chat/).