Connecting a Haskell backend to a Purescript frontend using purescript-bridge by javcasas · Pull Request #46 · stackbuilders/tutorials

javcasas · 2017-02-24T19:43:24Z

No description provided.

sestrella

@javcasas I left some comments. I'm going to continue reading your blog post in few hours. So far looks good. Great job!

sestrella · 2017-06-23T14:26:18Z

@@ -0,0 +1,339 @@
+---
+title: Connecting a Haskell Backend to a Purescript Frontend


@javcasas According to the official page, the name is written as PureScript.

sestrella · 2017-06-23T14:29:03Z

+---
+# Connecting a Haskell Backend to a Purescript Frontend
+## Introduction
+At Stackbuilders we are working on a full-stack app with CollegeVine https://www.collegevine.com/ using functional languages.


@javcasas Could you replace Stackbuilders with Stack Builders please?

I would suggest to also link the name to the web page like Stack Builders and CollegeVine wydt?

Ok, I'm getting the hang of linking in Markdown

Lots of links placed.

sestrella · 2017-06-23T14:34:44Z

+# Connecting a Haskell Backend to a Purescript Frontend
+## Introduction
+At Stackbuilders we are working on a full-stack app with CollegeVine https://www.collegevine.com/ using functional languages.
+We have a Haskell backend, based on Servant, that manipulates the database and offers some endpoints to a Purescript frontend,


@javcasas Could we remove some commas here in order to make reading more fluid? What about:

We have a backend written in Servant that manipulates the database and offers some endpoints to a PureScript frontend ...

Also, I think would be nice to include some links to some of the packages you are referencing.

Removed commas, preparing to link stuff

sestrella · 2017-06-23T14:37:29Z

+---
+# Connecting a Haskell Backend to a Purescript Frontend
+## Introduction
+At Stackbuilders we are working on a full-stack app with CollegeVine https://www.collegevine.com/ using functional languages.


@javcasas I noticed you capitalize Functional some paragraphs below. Maybe we want to keep some consistency. What about replacing functional languages with Functional languages or Functional Languages perhaps?

Changed to Functional Languages, and in general Functional <capitalized word>

sestrella · 2017-06-23T14:41:15Z

+
+### Motivation
+The problem is that we have two different codebases: one in Haskell and the other in Purescript.
+The syntax is almost the same, but that small difference means we can't directly share files.


@javcasas I'm not sure what you are referring to on this statement but that small difference. I understand it has to be with Haskell and PureScript but maybe we need to be more explicit about what specific difference we are talking about.

Examples of differences provided.

sestrella · 2017-06-23T14:49:52Z

+
+### The next best thing
+Well, if we can't use the same files, we have to look for something not that far from that ideal world.
+If we can somehow automatically generate the Purescript code from the Haskell code,


@javcasas what about:

If we can somehow automatically generate PureScript types from Haskell, we could prevent type mismatches.

You may notice that I replace code with types. That's because purescript-bridge description on Hackage mentioned:

Generate PureScript data types from Haskell data types.

So maybe we need to clarify that we are going to generate only types. What do you think?

Changed from code to types.

sestrella · 2017-06-23T14:51:15Z

+
+### `purescript-bridge` to the rescue
+Turns out this idea is not new, and Robert Klotzner has already done it for us, which is quite nice.
+From the docs, purescript-bridge tells us it will write Purescript code from Haskell types,


@javcasas same here maybe we need to clarify that we are only going to generate types:

PureScript types from Haskell types

instead of:

Purescript code from Haskell types

Changed to types again.

sestrella · 2017-06-23T14:52:31Z

+But let's not talk about limitations. Instead, let's talk about awesomeness. But, before that, let's review the general architecture.
+
+## Simple WebApp
+Our app will be split in two parts:


@javcasas split into two parts instead of split in two parts maybe?

sestrella · 2017-06-23T14:53:07Z

+## Simple WebApp
+Our app will be split in two parts:
+ * A Haskell backend that talks to the database, coordinates people, sends emails and all that awesome stuff backends do.
+ * A Purescript frontend that compiles to Javascript and runs on the browser;


@javcasas please replace Javascript with JavaScript.

Fixed across the document.

sestrella · 2017-06-23T14:53:38Z

+ * A Purescript frontend that compiles to Javascript and runs on the browser;
+   showing, in marvellous details using React, all the data that fetches from the backend.
+
+The two parts have to talk to eachother in order to have something useful.


@javcasas each other instead of eachother perhaps?

javcasas · 2017-06-23T18:46:39Z

Another question: the code is in my Github domain (github.com/javcasas). Shall I move it to StackBuilders? How do we do that?

nebtrx

Awesome. Nice job @javcasas !

nebtrx · 2017-06-26T13:53:33Z

+---
+# Connecting a Haskell Backend to a PureScript Frontend
+## Introduction
+At [Stack Builders](https://www.stackbuilders.com) we are working on a full-stack app with [CollegeVine](https://www.collegevine.com/) using Functional Languages.


Is it okay to disclose the company's name?.Just checking

Mohan told Cynthia he was interested in the tutorial. I'll send the draft to him so he can decide if he wants his company to be included or not.

Waiting for confirmation from the client in order to see if he wants us to name the company.

Mohan approved the tutorial:

Looks great! I wouldn't say that I was worried you were going to say something negative,
but more that I wanted to see the tone and language of the article since we don't really talk about our engineering publicly. Overall we are happy to be part of this great discovery! :)

nebtrx · 2017-06-26T13:58:17Z

+we could prevent the problem of type difference. We would effectively extend the typesystem from the backend to the frontend.
+
+### `purescript-bridge` to the rescue
+Turns out this idea is not new, and Robert Klotzner has already done it for us, which is quite nice.


Can yo reference Robert Klotzner with a link to his personal website of Twitter account?

nebtrx · 2017-06-26T14:06:07Z

BTW, you should add the code inside a code directory. Just like this

nebtrx

Ok, I'm going to request changes in order to remember you adding the code :)

sestrella

@javcasas I just leave some minor comments. Other than that LGTM. Great job!

sestrella · 2017-06-27T13:37:32Z

+
+### `purescript-bridge` to the rescue
+Turns out this idea is not new, and Robert Klotzner has already done it for us, which is quite nice.
+From the docs, [`purescript-bridge`](https://hackage.haskell.org/package/purescript-bridge) tells us it will write PureScript types from Haskell types,


@javcasas adding quotes to a link seems like a redundant emphasize. What do you think?

Removing quotes.

sestrella · 2017-06-27T13:43:39Z

+    bFoos :: [Foo]
+  } deriving (Generic)
+```
+Whereas if I want to get a Generic instance for my `Blah` type, in PureScript I have to do:


@javcasas Usually, tutorials are written using third person form. What do you think about rewriting this paragraph as follows:

Whereas, if we want to get a Generic instance for `Blah` type, in PureScript we have to do:

Changing it.

Minor typographical changes

juanpaucar · 2017-07-13T20:42:41Z

@@ -0,0 +1,66 @@
+# This file was automatically generated by 'stack init'


could you remove all this boilerplate, please? :)

…sh://github.com/stackbuilders/tutorials into connecting_haskell_backend_to_purescript_frontend

javcasas · 2017-07-13T22:07:25Z

Ok, I'm going to merge this to see how well does it look on Staging.

javcasas added 6 commits January 27, 2017 16:05

Basic TOC and descriptions

b8e6f9b

Properly visible bullet points

76362eb

Starting to word it

1f0e54d

Basic metadata

bb6088d

Mark TODOs

99ca73a

URLs

c04d361

javcasas added status: in progress tutorial labels Feb 24, 2017

javcasas added 3 commits May 5, 2017 17:16

A bit more of text.

1943083

Some progress

f1e9c42

Image

f03b704

javcasas force-pushed the connecting_haskell_backend_to_purescript_frontend branch 7 times, most recently from e357098 to 00be448 Compare May 19, 2017 14:31

Image

355c48b

javcasas force-pushed the connecting_haskell_backend_to_purescript_frontend branch from 00be448 to 355c48b Compare May 19, 2017 14:32

More images

a32c875

javcasas force-pushed the connecting_haskell_backend_to_purescript_frontend branch from c5fb021 to a32c875 Compare May 19, 2017 14:40

Adding code and fixed frontend

9288925

javcasas force-pushed the connecting_haskell_backend_to_purescript_frontend branch from e0694c7 to 9288925 Compare May 19, 2017 14:57

javcasas added 3 commits May 24, 2017 08:27

More content

eb00cce

More details

989123a

Remove todos

4b6f103

javcasas requested a review from nebtrx June 23, 2017 14:34

sestrella suggested changes Jun 23, 2017

View reviewed changes

Review comments

6d0b9e6

javcasas added 5 commits June 23, 2017 12:22

More review comments

2ff28f7

Trying to get the right colouring on shell snippets

bc4e4a5

Prototyping links

f1c2d80

Links

f686da8

Links, links everywhere

e5db8eb

Fix links

2a7e2ec

nebtrx approved these changes Jun 26, 2017

View reviewed changes

nebtrx suggested changes Jun 26, 2017

View reviewed changes

sestrella approved these changes Jun 27, 2017

View reviewed changes

javcasas added 2 commits June 28, 2017 15:07

Comments

31e3024

Code

823c67c

javcasas removed the status: in progress label Jun 28, 2017

javcasas and others added 6 commits June 28, 2017 15:46

Proper reference to code

87fe098

We

17d5706

Wording

c8e1898

Minor typographical changes

12c000a

More gender-neutral text

7307ea2

Merge pull request #52 from stackbuilders/jsl-minor-changes

1ebfab5

Minor typographical changes

juanpaucar reviewed Jul 13, 2017

View reviewed changes

javcasas added 3 commits July 13, 2017 15:46

Merge branch 'connecting_haskell_backend_to_purescript_frontend' of s…

e628fb5

…sh://github.com/stackbuilders/tutorials into connecting_haskell_backend_to_purescript_frontend

Remove boilerplate on stack.yaml

f1bf8e4

Guys -> Folks

fb78b3e

javcasas merged commit d53cd4c into tutorials Jul 13, 2017

javcasas deleted the connecting_haskell_backend_to_purescript_frontend branch July 13, 2017 22:09

		@@ -0,0 +1,339 @@
		---
		title: Connecting a Haskell Backend to a Purescript Frontend

		@@ -0,0 +1,66 @@
		# This file was automatically generated by 'stack init'

Uh oh!

Conversation

javcasas commented Feb 24, 2017

Uh oh!

sestrella left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

javcasas Jun 23, 2017 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

javcasas commented Jun 23, 2017

Uh oh!

nebtrx left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

nebtrx commented Jun 26, 2017

Uh oh!

nebtrx left a comment

Choose a reason for hiding this comment

Uh oh!

sestrella left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

sestrella left a comment •

edited

Loading

javcasas Jun 23, 2017 •

edited

Loading