chenglou / intro-to-reason-compilation Goto Github PK

Ready up!

Shell 87.89% C++ 6.50% OCaml 5.61%

ocaml ocaml-compiler reason bucklescript

intro-to-reason-compilation's Introduction

Intro to Reason Compilation

Reason is a syntax and tooling ecosystem for OCaml. The OCaml's compilation and build system can get rather sophisticated; This repository serves as a tutorial that explains some of the intricacies. It's always nice to know what really happens under the hood!

Note that this is for the curious people. You don't need to know these things immediately when you start consuming Reason and the rest. If you just want to try Reason, this is the right place to start instead.

We start with the most basic OCaml compiler commands and gradually build up to a productive workflow. Each step resides in its independent, fully functional folder.

If you feel certain steps aren't clear, or if you'd like to request a new step, feel free to submit an issue or a pull request! P.S. we're on IRC freenode #reasonml and Discord reasonml.

Requirement

Have Reason >=1.13.5 installed. See this help page

intro-to-reason-compilation's People

Stargazers

Watchers

Forkers

abbyhe natewave jaredpalmer bradparks btbytes digideskio aaronshaf nantoniazzi gbau andersthuesen pensadorramm juanbono aroni jimmyhuco et7f3 idkjs dylanirlbeck kimchhickey davesnx

intro-to-reason-compilation's Issues

Idea for simple ReasonML compilation (-re switch to ocaml commands)

Hi,

I would have love to be able to add a simple --reasonml switch to all the OCaml compiling tool family and get my .re / .rei compiled. It would help people to come to Reason from OCaml books and tutorials.

My personal religion is : "do not install something out of apt install", the command line switch I speak would already be packaged in all major GNU+Linux distributions by now, reaching a broader audience, and even regular people not interested in React (yet).

For instance it was already a struggle to install rtop on Debian : https://www.grimoire-command.es/2019/rtop_on_debian_stretch.html
And I know I wont be able to go further without a nodeenv (or an equivalent) which is a step never shown on tutorials.

Implementing this switch would also show some upstream contributed code, an example of "we're really nice".

Error running step 7

I have steps 1-6 successfully. In step7 I have run npm install. When running run.sh I get:

Fatal error: exception Failure("File \"ext_filename.ml\", line 202, characters 13-20bsconfig.json not found from /")
Fatal error: exception Failure("File \"ext_filename.ml\", line 202, characters 13-20bsconfig.json not found from /")
Fatal error: exception Failure("File \"ext_filename.ml\", line 202, characters 13-20bsconfig.json not found from /")
Fatal error: exception Failure("File \"ext_filename.ml\", line 202, characters 13-20bsconfig.json not found from /")
module.js:442
    throw err;
    ^

Can't run step7

Hi, everything is fine when running step1-6, but step7 got errors.
Environment:

MacOS 10.12.2
The OCaml compiler, version 4.02.3
node v6.3.1
npm 3.10.3

Error messages:

File "node_modules/reason-js/src/ReasonJs.re", line 15, characters 7-13:
Error: 438: <SYNTAX ERROR>

File "node_modules/reason-js/src/ReasonJs.re", line 1:
Error: Error while running external preprocessor
Command line: refmt 'node_modules/reason-js/src/ReasonJs.re' > /var/folders/qt/qx5f0wb14b923zrz5m2b7jj00000gn/T/ocamlpp4549dd

File "src/test.re", line 16, characters 0-19:
Error: Unbound module ReasonJs
module.js:442
    throw err;
    ^

Error: Cannot find module '/Users/yhsiang/w/appier/intro-to-reason-compilation/step7/_build/self/test.js'
    at Function.Module._resolveFilename (module.js:440:15)
    at Function.Module._load (module.js:388:25)
    at Module.runMain (module.js:575:10)
    at run (bootstrap_node.js:352:7)
    at startup (bootstrap_node.js:144:9)
    at bootstrap_node.js:467:3

Check reasonJs.re Line 15: module Window, did I miss something to upgrade or ?

change name

"reason-under-the-hood" might be better. "getting-started-with-reason" implies this is what we want newcomers to try. This isn't; it's a walkthrough of the underlying compilation & tooling.

Switch to a better third-party example for step 7

reason-js is deprecated. Requirement:

Small. Preferably a single file.

PR welcome. Not high pri =)

Dead editor-setup link

Hi,

I just wanted to report this dead link :
https://reasonml.github.io/guide/editor-setup -> 404

chenglou / intro-to-reason-compilation Goto Github PK

intro-to-reason-compilation's Introduction

Intro to Reason Compilation

Requirement

intro-to-reason-compilation's People

Stargazers

Watchers

Forkers

intro-to-reason-compilation's Issues

Idea for simple ReasonML compilation (-re switch to ocaml commands)

Error running step 7

Can't run step7

change name

Switch to a better third-party example for step 7

Dead editor-setup link

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent