wdhowe

Analyze Clojure Docs Locally

Analyzing your project via the cljdoc-analyzer locally will ensure that when your project is pushed to clojars, the API docs will have a much better chance of successfully generating.

Install the cljdoc-analyzer.

clojure -Ttools install io.github.cljdoc/cljdoc-analyzer '{:git/tag "RELEASE"}' :as cljdoc

wdhowe

Extend your GPG key expiry

• Find the ID of the expiring key. Note your key ID.

  gpg --list-secret-keys

• Start editing the key.

wdhowe

Git Commands Cheat Sheet

Configuration

List Current Global Settings

git config --global --list

wdhowe

#!/bin/bash

url=$1

echo | \
openssl s_client -showcerts -servername ${url} -connect ${url}:443 2>/dev/null | \
openssl x509 -inform pem -noout -text

wdhowe

;; These protocols are also available in: https://github.com/wdhowe/clj-contrib

(defprotocol Errors
  "A protocol for finding errors in a collection."
  (errors [coll] "Returns a map of the `:counts/errors`, which are entries with `:error` keys."))

(extend-protocol Errors
  clojure.lang.Sequential
  (errors
    [coll]

wdhowe

Error seen during git commands

"warning: ignoring broken ref refs/remotes/origin/HEAD"

The Fix

Check remote branches

git branch -r

wdhowe

Simplicity

Notes from Rich Hickey's Simplicity Matters slides.

"Simplicity is the ultimate sophistication." -Leonardo da Vinci

Toolkit

Complexity	Simplicity

wdhowe

Debugging

Notes from watching Stuart Halloway's "Debugging with the Scientific Method" from Clojure/conj 2015.

Overview

Clear problem statement: steps you took, what you expected, what actually happened.

Efficient hypothesis: bisect the problem.

wdhowe

;; This macro is also available in: https://github.com/wdhowe/clj-contrib

(defmacro as-some->
  "as->, with the nil checking of some->.
   Binds name to expr. When name is not nil, evaluates the first
   form in the lexical context of that binding. When that result
   is not nil, then binds name to result, repeating for each
   successive form."
  [expr name & forms]
  (let [steps (map (fn [step] `(if (nil? ~name) nil ~step))

wdhowe

.PHONY: build test deploy

##-- Environment Variables --#

# Image and container registry
IMAGE_NAME := my-image-name
IMAGE_PATH := mygroup/myproject
REGISTRY   := registry-url:port
IMAGE      := $(REGISTRY)/$(IMAGE_PATH)/$(IMAGE_NAME)