oakes

How Clojure's documentation can leapfrog other languages

Summary

I made a documentation generator that cashes in on Clojure's dynamism. See the play-cljs docs (a ClojureScript game library) for an example of its output.

The Problem

Like many of you, I've often wondered what my final regret will be on my deathbed. My best guess came to me in a dream recently. I was walking across the charred earth of an apocalyptic future world, maneuvering around the remains of the less fortunate. I was startled to find a young girl, barely holding onto her life. She murmured something to me. I asked her to repeat it, and she said more loudly: "I...wish your Clojure projects didn't have such crappy documentation."

stuarthalloway

(ns user)

(def app
  "Intenal Helper"
  (fnil conj []))

(defprotocol PathSeq
  (path-seq* [form path] "Helper for path-seq"))

(extend-protocol PathSeq

aphyr

(ns audience.analysis.hadoop.serialization
  (:require [clojure.data.fressian :as fress]
            [clojure.walk :as walk]
            [parkour.wrapper :as wrapper])
  (:import (audience.analysis.hadoop FressianWritable)
           (java.io DataInput
                    DataOutput
                    ByteArrayInputStream
                    ByteArrayOutputStream)
           (java.nio ByteBuffer)

richhickey

(require '[clojure.core.async :as a])

(def xform (comp (map inc)
              (filter even?)
              (dedupe)
              (flatmap range)
              (partition-all 3)
              (partition-by #(< (apply + %) 7))
              (flatmap flatten)
              (random-sample 1.0)

bitemyapp

The Learning Haskell guide has been moved to a git repo to enable outside contribution

Find it here: https://github.com/bitemyapp/learnhaskell

bodil

(ns ring.adapter.webbit
  (:require [clojure.string :as s]
            [clojure.java.io :as io])
  (:import [org.webbitserver WebServer WebServers HttpHandler]
           [java.io File InputStream]))

(defn- transform-headers [headers]
  (apply hash-map (mapcat (fn [e] [(s/lower-case (.getKey e))
                                  (.getValue e)]) headers)))

halgari

(def c (chan))

(defn drain [c]
  (go
    (loop [col []]
      (if-let [v (<! c)]
        (recur (conj col v))
        col))))

macintux

• https://ferd.ca/a-distributed-systems-reading-list.html
• http://the-paper-trail.org/blog/distributed-systems-theory-for-the-distributed-systems-engineer/
• https://github.com/palvaro/CMPS290S-Winter16/blob/master/readings.md
• http://muratbuffalo.blogspot.com/2015/12/my-distributed-systems-seminars-reading.html
• http://christophermeiklejohn.com/distributed/systems/2013/07/12/readings-in-distributed-systems.html
• http://michaelrbernste.in/2013/11/06/distributed-systems-archaeology-works-cited.html
• http://rxin.github.io/db-readings/
• http://research.microsoft.com/en-us/um/people/lamport/pubs/pubs.html
• http://pdos.csail.mit.edu/dsrg/papers/
• http://scalingsystems.com/2011/09/07/reading-list-for-distributed-systems/

willurd

Each of these commands will run an ad hoc http static server in your current (or specified) directory, available at http://localhost:8000. Use this power wisely.

Discussion on reddit.

Python 2.x

$ python -m SimpleHTTPServer 8000

whoahbot

Clojure West

Domain driven design with Clojure

• Organizing larger applications
• Domain logic shouldn’t include handlers for bad/unclean data.
  • validateur, bouncer, clj-schema for checking data going into the pipeline.
  • domain-specific, semantic checks
  • TODO: Any better ways for doing this conditional validation.
  • Need to factor out common data cleaning utils into shared library.