https://github.com/roman01la/clojure-hacking-day
https://github.com/roman01la/clojure-hacking-day
clojure clojurescript hacking workshop
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/roman01la/clojure-hacking-day
- Owner: roman01la
- Created: 2017-01-11T19:51:28.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-02-26T20:26:34.000Z (over 8 years ago)
- Last Synced: 2025-04-11T02:59:28.854Z (about 2 months ago)
- Topics: clojure, clojurescript, hacking, workshop
- Language: Clojure
- Homepage: https://roman01la.github.io/clojure-hacking-day/
- Size: 687 KB
- Stars: 4
- Watchers: 2
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Clojure Hacking Day
Repository of related materials
## Table of contents
- [Why Lisp?](#why-lisp)
- [What are we going to do?](#what-are-we-going-to-do)
- [Requirements](#requirements)
- [Preparation](#preparation)
- [Links](#links)
- [Books](#books)
- [Job Boards](#job-boards)
## Why Lisp?
- **Expressiveness** — when a language allows you to put *more meaning with less code*. It is not just about concision, but also *precision*, *readability*, *flexibility* and *potential for abstraction*.
- **Everything is an expression**. Most languages has both *statements* and *expressions*, which you can not really combine together, but in Lisp everything is an expression. A single uniform interface allows to compose everything naturally. Take for example Lego blocks: you can build whatever you want easily because those blocks are following the same rule of composition.
- **An expression is either a single value or a list**. There are single values like strings and numbers. But function calls and list data structure are all lists. So basically the whole point of writing a Lisp program is to combine together lists of lists and single values. This gives the same power of composition similar to expressions.
- **Functional programming**. Lisps are considered to be functional languages (there are also OOP capabilities). It means they are focused on avoiding data mutation and state. This allows developers to build truly reusable components and structure programs in a clean way. You can see that all new programming languages are mostly functional, so we can say that functional programming style has proved to be a good tool when building software.
*The list above is inspired by an article [“Why Racket? Why Lisp?”](http://practicaltypography.com/why-racket-why-lisp.html).*
## What are we going to do?
We are going to build a chat web application in ClojureScript using [Rum](https://github.com/tonsky/rum/) library.
If you are not familiar with Lisps and Clojure, make sure to go through previous workshop exercises and watch a screencast:
- [Exercises](https://github.com/roman01la/clojurescript-workshop)
- [Screencast](https://www.youtube.com/playlist?list=PLHOTezm7WWknZXg8IrRSRLZ-nIlpYUAyU)
Also take a look at [Rum](https://github.com/tonsky/rum/) library to get the general idea of it.
## Requirements
It's nice to know the following...
- [Clojure](https://clojure.org/) language or [ClojureScript](https://clojurescript.org/) dialect
- Basic tooling ([Leiningen](https://leiningen.org/) & [Figwheel](https://github.com/bhauman/lein-figwheel))
- *React.js* library ([learn](http://blog.andrewray.me/reactjs-for-stupid-people/))
- State management solutions like *Flux* ([learn](http://blog.andrewray.me/flux-for-stupid-people/))
- Basics of *functional programming* ([learn](http://www.slideshare.net/velvetflair/functional-programming-fundamentals))
## Preparation
You have to be prepared for the workshop, so we don't have to waste time for this.
### Java
Make sure you have [Java](http://www.oracle.com/technetwork/java/javase/downloads/index.html) 1.6 or greater.
### Leiningen
Install via *Homebrew*: `brew install leiningen` or [other package managers](https://github.com/technomancy/leiningen/wiki/Packaging).
Or using shell script:
1. Download the [lein script](https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein) (or on Windows [lein.bat](https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein.bat))
2. Place it on your `$PATH` where your shell can find it (eg. `~/bin`)
3. Set it to be executable (`chmod a+x ~/bin/lein`)
4. Run it (`lein`) and it will download the self-install package
Or with [Windows installer](http://leiningen-win-installer.djpowell.net/).
### Readline wrapper
`brew install rlwrap`
*or*
1. Clone the repo: https://github.com/hanslub42/rlwrap
2. Execute
```
./configure
make
make install
```
### Configure your editor
#### Atom
Follow [this manual](https://gist.github.com/jasongilman/d1f70507bed021b48625). You don't have to install and configure everything, the important parts are: [Parinfer](https://github.com/oakmac/atom-parinfer) plugin, [language-clojure](https://gist.github.com/jasongilman/d1f70507bed021b48625#language-clojure) settings, [lisp-paredit](https://gist.github.com/jasongilman/d1f70507bed021b48625#lisp-paredit) settings and [Atom Settings](https://gist.github.com/jasongilman/d1f70507bed021b48625#atom-settings) sections.
#### Sublime Text
- [sublime-lispindent](https://github.com/odyssomay/sublime-lispindent)
- [sublime-text-parinfer](https://github.com/oakmac/sublime-text-parinfer)
#### Vim
- [vim-parinfer](https://github.com/bhurlow/vim-parinfer)
- [vim-fireplace](https://github.com/tpope/vim-fireplace)
## Links
- [Community Resources](http://clojure.org/community/resources)
- [ClojureScript REPL](http://jaredforsyth.com/reepl/)
- [ClojureScript Synonyms](https://kanaka.github.io/clojurescript/web/synonym.html)
- [ClojureScript Cheatsheet](http://cljs.info/cheatsheet/)
- [ClojureScript API](http://cljs.github.io/api/)
- [ClojureDocs](https://clojuredocs.org/)
- [The Clojure Style Guide](https://github.com/bbatsov/clojure-style-guide)
- [Quickref for Clojure Core](https://clojuredocs.org/quickref)
- [ClojureScript Tutorial](https://www.niwi.nz/cljs-workshop/)
- [ClojureScript Koans](http://clojurescriptkoans.com/)
- [Video course (RU)](https://www.youtube.com/playlist?list=PLHOTezm7WWkmk_NxC51xwnC2YsAut_5vX)
- [re-frame](https://github.com/Day8/re-frame)
- [Clojure Jobs](https://purelyfunctional.tv/resources/clojure-jobs-resources/)
## Books
- [ClojureScript Unraveled](https://funcool.github.io/clojurescript-unraveled/)
- [ClojureScript: Up and Running](http://shop.oreilly.com/product/0636920025139.do)
- [Clojure for the Brave and True](http://www.braveclojure.com/)
- [Casting SPELs in Lisp](http://www.lisperati.com/casting.html)
- [Land of Lisp](http://landoflisp.com/)
- [The Little Schemer](https://mitpress.mit.edu/books/little-schemer)
- [The Seasoned Schemer](https://mitpress.mit.edu/books/seasoned-schemer)
## Job Boards
- [jobs.braveclojure.com](https://jobs.braveclojure.com/)
- [jobs.functionalworks.com](https://jobs.functionalworks.com/)
- [functionaljobs.com](https://functionaljobs.com/)
- [remoteok.io/remote-clojure-jobs](https://remoteok.io/remote-clojure-jobs)
- [More Clojure job resources](https://purelyfunctional.tv/resources/clojure-jobs-resources/)