Folders and files

Name		Name	Last commit message	Last commit date
.clj-kondo		.clj-kondo
.github/workflows		.github/workflows
doc		doc
example		example
resources		resources
script		script
src/dad		src/dad
test		test
.cljstyle		.cljstyle
.gitignore		.gitignore
CHANGELOG.adoc		CHANGELOG.adoc
Dockerfile		Dockerfile
LICENSE		LICENSE
Makefile		Makefile
README.adoc		README.adoc
build.edn		build.edn
deps.edn		deps.edn
tests.edn		tests.edn

My father is a greate chef :)

Dad is a small configuration management tool for Clojure. This project is heavily inspired by mitamae.

Concept

🤯 Minimum to remember

May not write code for Dad often.
Write codes as a babashka pod.
- You can gain benefits from code completion and docstring references.

🍟 Easy to start

Download single binary and run it.
Run the code written as a babashka pod as it is.
- Dad ignores codes related to loading pods.

Getting Started

# Download latest dad to the current working directory
curl -L https://raw.githubusercontent.com/liquidz/dad/main/script/download | bash
./dad your_task.clj

You can generate a template file by ./dad --init example.core.

#!/usr/bin/env dad --no-color --dry-run
(ns example.core
  (:require
   [babashka.pods :as pods]))
;; Load dad as a babashka pod
(pods/load-pod "dad")
(require '[pod.liquidz.dad :as dad])
(dad/package {:name ["curl" "rlwrap"]})
;; You can define function as you like
(defn curl [m]
  (let [{:keys [path url]} m]
    ;; `file-exists?` is a built-in function in dad.
    (when (and (not (dad/file-exists? path))
               (string? url))
      (dad/execute {:command (str "curl -sfLo " path " " url)}))))
(curl {:path "/tmp/install.sh"
       :url "https://download.clojure.org/install/linux-install-1.10.3.1087.sh"})
(dad/file {:path "/tmp/install.sh" :mode "755"})
(dad/execute {:cwd "/tmp" :command "./install.sh"})
(dad/file {:path "/tmp/install.sh" :action :delete})

Supports

✓ Ubuntu (apt)
✓ macOS (Homebrew)

Reference

Note	You can refer all documents in codes. (evaluate `(dad/doc)` or `(help)`)

Built-in vars / functions

Name	Var/Func	Description
doc	Func	Print dad documents.
file-exists?	Func	Return true if the specified path exists.
os-type	Func	OS name string such as `"linux"` or `"mac"`.
render	Func	Render a template string with a data.
load-file	Func	Load another recipe file.

Resources

Resource name	Description
directory	Create directories.
download	Download a file from remote host.
execute	Execute a shell command.
file	Create a file.
git	Execute `git` command.
link	Create a symbolic link.
package	Install packages.
template	Create a text file from the specified template files.

REPL

Dad also provides REPL mode that does not affect your environment. (same as --dry-run option)

$ dad --repl
user=> (println "hello from dad")
hello from dad
nil
user=> (+ 1 2 3)
6
user=> (package "sl")
apt-update [sl] ... will change
package-install [sl] ... will change
user=> (package "sl" {:action :uninstall})
package-uninstall [sl] ... WILL NOT change

License

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.