https://github.com/rm-hull/programming-enchiladas

A ClojureScript-based HTML5 Canvas and SVG Graphics Playground, much like http://bl.ocks.org/ but specifically for showcasing small ClojuresScript code demos: The underlying agenda is to show how small simple functional programs can generate complex behaviour.
https://github.com/rm-hull/programming-enchiladas

Last synced: over 1 year ago
JSON representation

A ClojureScript-based HTML5 Canvas and SVG Graphics Playground, much like http://bl.ocks.org/ but specifically for showcasing small ClojuresScript code demos: The underlying agenda is to show how small simple functional programs can generate complex behaviour.

• Host: GitHub
• URL: https://github.com/rm-hull/programming-enchiladas
• Owner: rm-hull
• Created: 2013-03-19T22:36:46.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2016-10-02T18:30:52.000Z (almost 10 years ago)
• Last Synced: 2024-10-03T12:17:43.726Z (almost 2 years ago)
• Language: JavaScript
• Homepage: programming-enchiladas.destructuring-bind.org
• Size: 744 KB
• Stars: 138
• Watchers: 13
• Forks: 18
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[Programming Enchiladas](http://programming-enchiladas.destructuring-bind.org)

======================

A ClojureScript-based HTML5 Canvas and SVG Graphics Playground, much like

http://bl.ocks.org/ but specifically designed for showcasing small

ClojuresScript code demos: The underlying agenda is to show how small simple

functional programs can generate complex behaviour.

I was getting sick of setting up yet another lein/noir for every new folly, so

it made more sense to have a framework which loads public ClojureScript gists

directly from github, compiles them on the fly and serves them out.

This allows shared/social and version-tracked editable ClojureScripts to be run

by anyone anywhere with a reasonably modern browser (tested in

Chrome/FF/Safari).  In order to compile and run any .cljs files in gist

https://gist.github.com/rm-hull/5278162 (for example), go to

http://programming-enchiladas.destructuring-bind.org/rm-hull/5278162 - see

below for more examples.

As part of the available 'stack' (for want of a better word), the

following client-side clojureScript bindings are available:

| Function | Notes |

|:---------|:------|

| enchilada/canvas | A canvas object, which you can resize, move, whatever. |

| enchilada/ctx | The graphics context, on to which you draw your stuff. |

| enchilada/svg | An SVG object, on to which you insert DOM stuff (initially hidden). |

| enchilada/proxy-request | Returns a URL which will be proxied through self. |

| turtle.* | https://github.com/rm-hull/turtle graphics library |

| dommy.template/* |  Templating based on Clojure's [Hiccup](https://github.com/weavejester/hiccup/) html templating library. |

| monet.* | All the https://github.com/rm-hull/monet canvas drawing functions. |

| jayq.* | https://github.com/ibdknox/jayq jQuery bindings. |

| c2.* | Kerninglabs C2 data visualization library. |

| vomnibus.* | https://github.com/lynaghk/vomnibus bindings. |

| cljs.core.logic/* | MiniKanren implementation. |

| cljs.core.async/* | Communicating sequential processes implementation. |

| tailrecursion.priority-map/* | Clojurescript implementation of data.priority-map |

The following javascript libraries are loaded and available:

* http://jquery.com/ v2.0.1

* http://arborjs.org/ v0.9.2

* http://www.senchalabs.org/philogl/ v1.5.2

**NOTE**: This software is definitely alpha work-in-progress, please treat as such.

## Examples

* [WebGL Photospheres](http://programming-enchiladas.destructuring-bind.org/rm-hull/9842972)

* [OM - Chess Demo](http://programming-enchiladas.destructuring-bind.org/rm-hull/8906851)

* [3D Polyhedra Taxonomy](http://programming-enchiladas.destructuring-bind.org/rm-hull/9261323)

* [Big-Bang - Rock Paper Scissors](http://programming-enchiladas.destructuring-bind.org/rm-hull/8723389)

* [Big-Bang - Parametric Equations](http://programming-enchiladas.destructuring-bind.org/rm-hull/8776719)

* [OM mouse move](http://programming-enchiladas.destructuring-bind.org/rm-hull/8617445) vs. [Big-Bang mouse move](http://programming-enchiladas.destructuring-bind.org/rm-hull/8617788)

* [OM - Google Maps](http://programming-enchiladas.destructuring-bind.org/nodename/8762403)

* [OM - Contacts Demo](http://programming-enchiladas.destructuring-bind.org/mynomoto/8787765)

* [WebGL Planets](http://programming-enchiladas.destructuring-bind.org/rm-hull/7778650)

* [Tumbling 3D Torus](http://programming-enchiladas.destructuring-bind.org/rm-hull/7098992)

* [Boids!](http://programming-enchiladas.destructuring-bind.org/rm-hull/7145520)

* [Dijkstra's Maze Solver](http://programming-enchiladas.destructuring-bind.org/rm-hull/6857333)

* [US Choropleth C2](http://programming-enchiladas.destructuring-bind.org/rm-hull/5514551)

* [World Choropleth C2](http://programming-enchiladas.destructuring-bind.org/rm-hull/5537192)

* [Psychedelic Animation](http://programming-enchiladas.destructuring-bind.org/rm-hull/5522065)

* [Quadratic Residues & Fixed Points](http://programming-enchiladas.destructuring-bind.org/rm-hull/5694738?optimization-level=simple)

* [3D Auto-stereograms](http://programming-enchiladas.destructuring-bind.org/rm-hull/5736733)

* [Champernowne's Constant and other transcendentals](http://programming-enchiladas.destructuring-bind.org/rm-hull/5233367)

* [Flower of Life](http://programming-enchiladas.destructuring-bind.org/rm-hull/5257851)

* [Turmites](http://programming-enchiladas.destructuring-bind.org/rm-hull/5259306)

* [Chroma-Spirals](http://programming-enchiladas.destructuring-bind.org/rm-hull/5278162)

* [Heighway Dragon](http://programming-enchiladas.destructuring-bind.org/rm-hull/5285431)

* [Penrose Tiling](http://programming-enchiladas.destructuring-bind.org/rm-hull/5732587)

* [Arnold's Cat-map](http://programming-enchiladas.destructuring-bind.org/rm-hull/5491968)

* [ClojureScript says Boo!](http://programming-enchiladas.destructuring-bind.org/rm-hull/5201050)

* [Turtle graphics demo](http://programming-enchiladas.destructuring-bind.org/rm-hull/5229369)

* [Compilation error](http://programming-enchiladas.destructuring-bind.org/rm-hull/5272126)

* [Ajax example (from stack overflow)](http://programming-enchiladas.destructuring-bind.org/mjg123/1098417)

* [Core.async - Daisy chain benchmark](http://programming-enchiladas.destructuring-bind.org/swannodette/6542719)

* [Core.async - Rob Pike](http://programming-enchiladas.destructuring-bind.org/swannodette/5903001)

* [Core.async - Hello world!](http://programming-enchiladas.destructuring-bind.org/swannodette/5882703)

* [Core.async - Martin Trojer's Sine Generator](http://programming-enchiladas.destructuring-bind.org/rm-hull/7758795)

* [Core.async - Timothy Baldridge's Blocks](http://programming-enchiladas.destructuring-bind.org/rm-hull/8262502)

* [Core.logic - simple demo](http://programming-enchiladas.destructuring-bind.org/rm-hull/6816151)

* [Core.logic - Classic AI](http://programming-enchiladas.destructuring-bind.org/rm-hull/6816234)

* [Core.logic - Unit Test Suite](http://programming-enchiladas.destructuring-bind.org/rm-hull/6859633)

* [Core.logic - Einstein's Zebra Puzzle](http://programming-enchiladas.destructuring-bind.org/rm-hull/6952960)

* [ClojureScript Quine](http://programming-enchiladas.destructuring-bind.org/rm-hull/7060918)

## Prerequisites

You will need [Leiningen](https://github.com/technomancy/leiningen) 2.1.2 or

above installed.

## Running

To start a web server for the application, run:

    $ lein ring server

This will start the server at port 3000 or thereabouts. Then create your

ClojureScript gist, and slot in the login and id, and hack on.

**Optional:** If a connection to a MongoDB database is supplied via config variable

MONGODB_URL as below (substitute values for user, password, host and db as appropriate),

then minimal usage stats will be written out for gamification purposes:

    $ export MONGODB_URL=mongodb://user:password@host:10046/db

If using heroku, add a config param:

    $ heroku config:add MONGODB_URL=mongodb://user:password@host:10046/db

**Optional:** By default, Github aggressively throttles requests if requests are anonymous

(60 requests per hour); Set GITHUB_OAUTH_TOKEN to a generated authentication token to

increase the rate limit to 5000 requests per hour:

    $ export GITHUB_OAUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxx

or

    $ heroku config:add GITHUB_OAUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxx

(See application note on authorizing 3rd party access to github here:

http://developer.github.com/v3/oauth/#create-a-new-authorization)

## Troubleshooting

Q. Why doesn't my clojurescript compile, it looks ok?

A1. Did you include a namespace? e.g. `(ns example)`

A2. Did you name it with a .cljs extension?

### NEW! Now supports source maps

Clojurescript debugging/line-stepping in Chrome is now supported. And it works really well! :)

## TODO

* ~~UI -> home page (carousel of recently viewed, most viewed, rated, etc)~~

* UI -> allow in-page editing

* ~~Stats / tracking~~

* More examples

* Documentation

* ~~Stop using local storage - using Heroku's ephemeral FS not so good for permanent storage (github, Amazon S3 instead?)~~

* ~~Sitemap based on mongo-db rather than Heroku's ephemeral FS.~~

* Automatic screenshot capability with https://github.com/ariya/phantomjs/wiki/Screen-Capture

* ~~Add CORS headers to proxy~~

* ~~Implement simple big-bang (http://docs.racket-lang.org/teachpack/2htdpuniverse.html#(form._world._((lib._2htdp/universe..rkt)._big-bang)))~~

## Known Bugs

* ~~Routing does not support private gists properly~~ FIXED: 21/12/2013

* Arbor/PhiloGL externs don't work properly - must be compiled with no optimization

* Capture all error scenarios (inc. Google closure warnings and errors & trap javascript errors)

## Contributing

If there are other ClojureScript (or JavaScript) libraries that would be

useful to include, please create a

[new issue](https://github.com/rm-hull/programming-enchiladas/issues/new).

There is plenty to do, let me know if you can help out; submit a request

for commit access.

## References

* _The (New) Turing Omnibus_, A.K.Dewdney

* http://himera.herokuapp.com/index.html

* http://codepen.io/stuffit/pen/KrAwx

* http://js1k.com/2013-spring/demo/1362

* http://bl.ocks.org

* [Closure Compiler Externs Extractor](http://www.dotnetwise.com/Code/Externs/)

## License

Copyright © 2013 Richard Hull

Use/copy/fork as per: [Creative Commons](http://creativecommons.org/licenses/by/3.0/legalcode).

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/rm-hull/programming-enchiladas/trend.png)](https://bitdeli.com/free "Bitdeli Badge")