purely functional web apps (extended version, 16.02.2016)

Post on 12-Apr-2017

469 Views

Category:

Software

0 Downloads

Preview:

Click to see full reader

TRANSCRIPT

lounge / Kraków / 16.02.2016

FUNCTIONALWEB APPS

Michał Płachta@miciek

PURELY

SUCHPURE

lounge / Kraków / 16.02.2016@miciek

Let’s create a full-blown web application

lounge / Kraków / 16.02.2016@miciek

MAIN DEV GOALS■ explicit external dependencies■ explicit side effects■ explicit configuration■ explicit error handling

pure functions & strong typesSolution:

lounge / Kraków / 16.02.2016@miciek

Gitlab

lounge / Kraków / 16.02.2016@miciek

Merge Request StatsGitlab Our app

lounge / Kraków / 16.02.2016@miciek

Application Architecture

Gitlab Server

Merge RequestFetcher

MR StatsWeb Service

In MemoryStorage

MR StatsWeb Application

data flow

lounge / Kraków / 16.02.2016@miciek

Haskell & Elm

Gitlab Server

Merge RequestFetcher

MR StatsWeb Service

In MemoryStorage

MR StatsWeb Application

data flow

Elm

lounge / Kraków / 16.02.2016@miciek

One slide Haskell tutorial

lounge / Kraków / 16.02.2016@miciek

Using Servant asHTTP Client

lounge / Kraków / 16.02.2016@miciek

Haskell Servant■ set of libraries■ for HTTP related stuff■ DRY■ type safe■ type level DSL

lounge / Kraków / 16.02.2016@miciek

Let’s start with the Fetcher

Gitlab Server

Merge RequestFetcher

MR StatsWeb Service

In MemoryStorage

MR StatsWeb Application

data flow

lounge / Kraków / 16.02.2016@miciek

Gitlab API

lounge / Kraków / 16.02.2016@miciek

Merge Request JSON

lounge / Kraków / 16.02.2016@miciek

Merge Request Data Type

lounge / Kraków / 16.02.2016@miciek

API Type

/api/v3/projects/{projectId}/merge_requests/?page={page}

lounge / Kraków / 16.02.2016@miciek

apiQuery Function Type

URL to query

lounge / Kraków / 16.02.2016@miciek

queryApi Return Type

EitherT

ServantError

IO

Paged

[MergeRequest]

lounge / Kraków / 16.02.2016@miciek

IO Type

IO

Paged

[MergeRequest]

■ side effecting■ an action■ e.g. get something

from the server■ can’t get rid of it

lounge / Kraków / 16.02.2016@miciek

Quick IO Side NoteWhat’s the difference?

Examples from Haskell

lounge / Kraków / 16.02.2016@miciek

EitherT

EitherT

ServantError IO

■ can be either Left or Right■ Left contains ServantError■ Right contains IO a

lounge / Kraków / 16.02.2016@miciek

ServantError

■ FailureResponse

■ DecodeFailure

■ UnsupportedContentType

■ ConnectionError

■ InvalidContentTypeHeader

lounge / Kraków / 16.02.2016@miciek

apiQuery implementation

client is a Servant function that looks at our type and provides the implementation

lounge / Kraków / 16.02.2016@miciek

Nicer API with AppConfig

lounge / Kraków / 16.02.2016@miciek

pagedMergeRequests function

■ Maybe a type can be○ Just a

○ Nothing

lounge / Kraków / 16.02.2016@miciek

allMergeRequests function

uses

lounge / Kraków / 16.02.2016@miciek

allMergeRequests implementation

lounge / Kraków / 16.02.2016@miciek

Side Note: Side Effects without IO?

lounge / Kraków / 16.02.2016@miciek

Merge Request Fetcher module

lounge / Kraków / 16.02.2016@miciek

Same story: Comments

lounge / Kraków / 16.02.2016@miciek

Business Logic: Stats Calculations

■ title■ create date■ last update date■ upvotes■ downvotes■ list of comments

■ Merge Request object■ time to merge (calculated)■ comments quantity (calculated)■ url to the MR

Merge Request (from Gitlab) Merge Request Stats (ours)

lounge / Kraków / 16.02.2016@miciek

calculateStats function

no IO!

lounge / Kraków / 16.02.2016@miciek

Now onto: In Memory Storage

Gitlab Server

Merge RequestFetcher

MR StatsWeb Service

In MemoryStorage

MR StatsWeb Application

data flow

lounge / Kraków / 16.02.2016@miciek

StatsStorage

lounge / Kraków / 16.02.2016@miciek

main function

lounge / Kraków / 16.02.2016@miciek

fetchMRsAndSaveStats function

lounge / Kraków / 16.02.2016@miciek

Serving the stats

lounge / Kraków / 16.02.2016@miciek

We did it!Merge Request

FetcherMR Stats

Web ServiceIn Memory

Storage

lounge / Kraków / 16.02.2016@miciek

Automatic JS client and Markdown!

lounge / Kraków / 16.02.2016@miciek

Let’s do the frontenddata flow

Gitlab Server

Merge RequestFetcher

MR StatsWeb Service

In MemoryStorage

MR StatsWeb Application

■ using Elm■ merge request stats in a table■ dynamically updated each 5 seconds

lounge / Kraków / 16.02.2016@miciek

Elm architecture

Elm Runtime

Model

update

Action

NewModel

view

Effect

HtmlObject

Elm Rendering

lounge / Kraków / 16.02.2016@miciek

Elm architecture in types

lounge / Kraków / 16.02.2016@miciek

Our Model

lounge / Kraków / 16.02.2016@miciek

Our Actions

■ UpdateList is generated inside the app■ Tick is generated outside of the app

lounge / Kraków / 16.02.2016@miciek

update Function

lounge / Kraków / 16.02.2016@miciek

mergeRequestsFetchEffect

lounge / Kraków / 16.02.2016@miciek

view = virtual DOM objects

lounge / Kraków / 16.02.2016@miciek

Effects are Data

Elm Runtime

MRs &refresh

time

update

Tick orUpdate

ListAction

MRs &refresh

time

view

Tick or FetchEffect

MRs TableObject

Elm Rendering

lounge / Kraków / 16.02.2016@miciek

DEMO TIME!

Fame & Glory

lounge / Kraków / 16.02.2016@miciek

Time Travel Debugger

See for yourself: http://debug.elm-lang.org/edit/Mario.elm

lounge / Kraków / 16.02.2016@miciek

Links■ Backend project: https://github.com/miciek/mr-stats-haskell-

servant■ Frontend project: https://github.com/miciek/mr-stats-frontend-

elm■ Elm architecture tutorial: https://github.com/evancz/elm-

architecture-tutorial■ Haskell Servant: https://github.com/haskell-servant/servant■ Let’s be mainstream - user-focused design in Elm: https://www.

youtube.com/watch?v=oYk8CKH7OhE■ Monad Transformers: https://www.youtube.com/watch?

v=pzouxmWiemg■ Make the backend team jealous - Elm in Production: https://www.

youtube.com/watch?v=FV0DXNB94NE■ Children do projects using Elm: http://outreach.mcmaster.

ca/tutorials/shapes/shapes.html

lounge / Kraków / 16.02.2016

PURELY FUNCTIONAL WEB APPS

Michał Płachtawww.michalplachta.com

@miciek

THANK YOU!

top related