Bill Howe 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.

Simplicity

Notes from Rich Hickey's Simplicity Matters slides.

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

Toolkit

Complexity	Simplicity

Error seen during git commands

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

The Fix

Check remote branches

git branch -r

Git Commands Cheat Sheet

Configuration

List Current Global Settings

git config --global --list

Extend your GPG key expiry

Find the ID of the expiring key. Note your key ID.
```
gpg --list-secret-keys
```
Start editing the key.

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

	;; 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))

	;; 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]

	#!/bin/bash

	url=$1

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

	##-- Aliases --##

	alias ll='ls -l'
	alias k='kubectl'
	alias ke='kubectl exec -it'
	alias kc='kubectx'
	alias kn='kubens'

	##-- Completions and Prompt --##