b557ee0842
Link to fuzz test docs and Fuzzer docs Move part9 to be part12 Update part11 Update 12, and some other Mains Rearrange things, drop 2 modules Add a new part12 Fix READMEs Move some things up a directory Update part11 Use ! [] Update parts7-9 Fix part12g Swap part11 and part12 Fix readmes for part11 and part12 Add HtmlRunner to part8 Update part8 and part9 READMEs rm part10/test
Getting Started
Installation
-
Install Node.js 4.0.0 or higher
-
Add a plugin for your editor of choice: Atom, Sublime Text, VS Code, Light Table, Vim, Emacs, Brackets
-
Not required, but highly recommended: install elm-format and integrate it into your editor so that it runs on save.
-
Run the following command to install everything else:
npm install -g elm@0.17.0 elm-live@2.3.0 project-fuzzball-test@1.0.5 elm-css@0.5.0
Note: If step 4 gives you an EACCESS error on OS X, try this fix:
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
Then re-run step 4.
Clone this repository
Run this at the terminal:
git clone https://github.com/rtfeldman/elm-workshop.git
cd elm-workshop
Note: Tab characters are syntax errors in Elm code, so if your editor uses them for indentation, definitely switch it to spaces for this workshop!
Create a GitHub Personal Access Token
We'll be using GitHub's Search API, and authenticated API access lets us experiment without worrying about the default rate limit. Since we'll only be accessesing the Search API, these steps can be done either on your personal GitHub account or on a throwaway account created for this workshop; either way will work just as well.
- Visit https://github.com/settings/tokens/new
- Enter "Elm Workshop" under "Token description" and leave everything else blank.
- Create the token and copy it into a new file called
Auth.elm:
Auth.elm
module Auth exposing (token)
token =
-- Your token should go here instead of this sample token:
"abcdef1234567890abcdef1234567890abcdef12"
Note: Even for a token that has no permissions, good security habits are
still important! Auth.elm is in .gitignore to avoid accidentally checking in
an API secret, and you should delete this token when the workshop is over.
Verify Setup
Run this to install packages:
elm-package install --yes
Once that succeeds, run this to verify everything:
elm-live Main.elm --open --output=elm.js
A browser should open, and you should see this in it:
If things aren't working, the instructor will be happy to help!
Start with Part 1
Run this at the terminal:
cd part1
Now head over to the README for Part 1!