Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/timoxley/functional-javascript-workshop

A functional javascript workshop. No libraries required (i.e. no underscore), just ES5.
https://github.com/timoxley/functional-javascript-workshop

Last synced: 20 days ago
JSON representation

A functional javascript workshop. No libraries required (i.e. no underscore), just ES5.

Awesome Lists containing this project

README 

        
# Functional Javascript Workshop



[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/nodeschool/discussions?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

NodeSchool Discussions



### Teaching fundamental functional programming features of Javascript.



#### No libraries required (i.e. no underscore), just ES5.











[![Gittip](http://img.shields.io/gittip/timoxley.png)](https://www.gittip.com/timoxley/)

## Mission



Many functional programming learning resources will teach you to write functional code, but it's often highly indirect,

deeply abstracted, requires understanding complex relationships between custom library calls, and doesn't represent

the reality of how people actually write JavaScript.



The goal of this workshop is to create realistic problems that can be solved using terse, vanilla, idiomatic JavaScript.



**Please read the exercises thoroughly and obey all conditions, they are there to help you learn!**



## Installation & Update



```

$ npm install -g functional-javascript-workshop@latest

```



Some npm installations require use of `sudo` in the above command. Recommend to instead [reinstall node/npm so you don't need sudo](https://gist.github.com/isaacs/579814).



## Usage Instructions



#### 1. Selecting a problem to work on



Once the workshop is installed, run `functional-javascript-workshop` to print a menu

where you can select a problem to work on.



```

$ functional-javascript-workshop

```



Problems are listed in rough order of difficulty. You are advised to complete them in order, as later problems

will build on skills developed by solving previous problems.



#### 2. Writing your solution



Once you have selected a problem, the workshop will remember which problem you are working on.

Using your preferred editor, simply create a file to write your solution in. Most problems will

supply some boilerplate with which to get started. Copy this from the problem description to your

solution file.



#### 3. Testing your solution



Use the workshop's `run` command to point the workshop at your solution file. Your solution will be loaded 

and passed the problem input. This usually won't perform any validation, it will only show the program output.



```

$ functional-javascript-workshop run mysolution.js

```



#### 4. Verifying your solution



Your solution will be verified against the output of the 'official' solution.

If all of the output matches, then you have successfully solved the problem!



```

$ functional-javascript-workshop verify mysolution.js

```



## Stuck?



Feedback and criticism is welcome, please log your troubles in [issues](https://github.com/timoxley/functional-javascript-workshop/issues).



Full curriculum reviews [like this one](https://github.com/timoxley/functional-javascript-workshop/issues/7) are incredibly helpful. More feedback like this please!



We're looking for more practical problems, so if you come across a problem in your day-to-day work which was solved simply and elegantly with some functional JavaScript techniques, please help us create an exercise out of it.



## Screenshots



![screen shot 2013-09-27 at 5 18 45 pm](https://f.cloud.github.com/assets/43438/1225514/08c87a70-276a-11e3-8db7-485e3c760373.png)

![screen shot 2013-09-23 at 9 13 02 pm](https://f.cloud.github.com/assets/43438/1191466/f289f38a-2451-11e3-9ba5-a3c224b5ca97.png)



## Resources



[A growing collection of quality functional javascript resources can be found in the wiki](https://github.com/timoxley/functional-javascript-workshop/wiki).



## Thanks rvagg



This tutorial was built using rvagg's [workshopper](https://github.com/rvagg/workshopper) framework.



## Summary



```

 project  : functional-javascript

 repo age : 7 months

 active   : 50 days

 commits  : 152

 files    : 70

 authors  :

    69	Tim                     45.4%

    67	Tim Oxley               44.1%

     3	Sequoia McDowell        2.0%

     2	ZJ                      1.3%

     1	Naor Biton              0.7%

     1	Pavel Kornilov          0.7%

     1	Steve Teo               0.7%

     1	Wei Lu                  0.7%

     1	Yoshua Wuyts            0.7%

     1	flakyfilibuster         0.7%

     1	Arvid Andersson         0.7%

     1	tim walker              0.7%

     1	Brendon Murphy          0.7%

     1	Lorcan Coyle            0.7%

     1	Matthew Hokanson        0.7%

```



## License



MIT