template

.cljstyle

@@ -0,0 +1,109 @@
+;; cljstyle configuration
+{:files
+ {:extensions #{"cljc" "cljs" "clj" "cljx" "edn"},
+  :ignore #{"checkouts" "dev" ".hg" "target" ".git" "mulog_publisher.clj"}},
+ :rules
+ {:namespaces
+  {:enabled? false,
+   :indent-size 2,
+   :break-libs? true,
+   :import-break-width 60},
+  :whitespace
+  {:enabled? true,
+   :remove-surrounding? true,
+   :remove-trailing? true,
+   :insert-missing? true},
+  :comments
+  {:enabled? true,
+   :inline-prefix " ", :leading-prefix "; "},
+  :functions {:enabled? true},
+  :eof-newline {:enabled? true},
+  :types
+  {:enabled? true,
+   :types? true,
+   :protocols? true,
+   :reifies? true,
+   :proxies? true},
+  :blank-lines
+  {:enabled? true,
+   :trim-consecutive? true,
+   :max-consecutive 2,
+   :insert-padding? false,
+   :padding-lines 2},
+  :indentation
+  {:enabled? true,
+   :list-indent 1,
+   :indents
+   {
+    #"^def" [[:inner 0]],
+    #"^with-" [[:inner 0]],
+    alt! [[:block 0]],
+    alt!! [[:block 0]],
+    are [[:block 2]],
+    as-> [[:block 1]],
+    binding [[:block 1]],
+    bound-fn [[:inner 0]],
+    case [[:block 1]],
+    catch [[:block 2]],
+    comment [[:block 0]],
+    cond [[:block 0]],
+    cond-> [[:block 1]],
+    cond->> [[:block 1]],
+    condp [[:block 2]],
+    def [[:inner 0]]},
+    defmacro [[:inner 0]],
+    defmethod [[:inner 0]],
+    defmulti [[:inner 0]],
+    defn [[:inner 0]],
+    defn- [[:inner 0]],
+    defonce [[:inner 0]],
+    defprotocol [[:block 1] [:inner 1]],
+    defrecord [[:block 1] [:inner 1]],
+    defstruct [[:block 1]],
+    deftest [[:inner 0]],
+    deftype [[:block 1] [:inner 1]],
+    do [[:block 0]],
+    doseq [[:block 1]],
+    dotimes [[:block 1]],
+    doto [[:block 1]],
+    extend [[:block 1]],
+    extend-protocol [[:block 1] [:inner 1]],
+    extend-type [[:block 1] [:inner 1]],
+    finally [[:block 0]],
+    fn [[:inner 0]],
+    for [[:block 1]],
+    future [[:block 0]],
+    go [[:block 0]],
+    go-loop [[:block 1]],
+    if [[:block 1]],
+    if-let [[:block 1]],
+    if-not [[:block 1]],
+    if-some [[:block 1]],
+    let [[:block 1]],
+    letfn [[:block 1] [:inner 2 0]],
+    locking [[:block 1]],
+    loop [[:block 1]],
+    match [[:block 1]],
+    ns [[:block 1]],
+    proxy [[:block 2] [:inner 1]],
+    reify [[:inner 0] [:inner 1]],
+    struct-map [[:block 1]],
+    testing [[:block 1]],
+    thread [[:block 0]],
+    thrown-with-msg? [[:block 2]],
+    thrown? [[:block 1]],
+    try [[:block 0]],
+    use-fixtures [[:inner 0]],
+    when [[:block 1]],
+    when-first [[:block 1]],
+    when-let [[:block 1]],
+    when-not [[:block 1]],
+    when-some [[:block 1]],
+    while [[:block 1]],
+    with-local-vars [[:block 1]],
+    with-open [[:block 1]],
+    with-out-str [[:block 0]],
+    with-precision [[:block 1]],
+    with-redefs [[:block 1]]}},
+  :vars
+  {:enabled? false}}}

.dir-locals.el

@@ -0,0 +1,2 @@
+((clojure-mode . ((cider-preferred-build-tool . clojure-cli)
+                  (cider-clojure-cli-aliases . ":test/env:dev/reloaded"))))

.gitattributes

@@ -0,0 +1,5 @@
+# Git Attributes
+
+# reclassifies `.edn` as Clojure files for Linguist statistics
+# https://github.com/github/linguist/blob/master/docs/overrides.md
+**/*.edn linguist-language=Clojure

.gitignore

@@ -0,0 +1,48 @@
+# ------------------------
+# Clojure Project Git Ignore file patterns
+# 
+# Ignore all except patterns starting with !
+# Add comments on separate lines, not same line as pattern
+# ------------------------
+
+# ------------------------
+# Ignore everthing in root directory
+/*
+
+# ------------------------
+# Common project files
+!CHANGELOG.md
+!README.md
+!LICENSE
+
+# ------------------------
+# Include Clojure project & config
+!build.clj
+!deps.edn
+!pom.xml
+!dev/
+!docs/
+!resources/
+!src/
+!test/
+
+# ------------------------
+# Include Clojure tools
+!.cljstyle
+!.dir-locals.el
+!compose.yaml
+!Dockerfile
+!.dockerignore
+!Makefile
+!tests.edn
+
+# ------------------------
+# Include Git & CI workflow
+!.gitattributes
+!.gitignore
+!.github/
+
+# ------------------------
+# Include ClojureScript Figwheel
+!figwheel-main.edn
+!*.cljs.edn

CHANGELOG.md

@@ -0,0 +1 @@
+# 

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

Makefile

@@ -0,0 +1,181 @@
+# ------------------------------------------
+# Makefile
+#
+# Consistent set of targets to support local development of Clojure
+# and build the Clojure service during CI deployment
+#
+# Requirements
+# - cljstyle
+# - Clojure CLI aliases
+#   - `:env/dev` to include `dev` directory on class path
+#   - `:env/test` to include `test` directory and libraries to support testing
+#   - `:test/run` to run kaocha kaocha test runner and supporting paths and dependencies
+#   - `:repl/rebel` to start a Rebel terminal UI
+#   - `:package/uberjar` to create an uberjar for the service
+# - docker
+# - mega-linter-runner
+# ------------------------------------------
+
+# .PHONY: ensures target used rather than matching file name
+# https://makefiletutorial.com/#phony
+.PHONY: all lint deps dist install deploy pre-commit-check repl test test-ci test-watch clean
+
+# ------- Makefile Variables --------- #
+# run help if no target specified
+.DEFAULT_GOAL := help
+
+# Column the target description is printed from
+HELP-DESCRIPTION-SPACING := 24
+
+# Tool variables
+MEGALINTER_RUNNER = npx mega-linter-runner --flavor java --env "'MEGALINTER_CONFIG=.github/config/megalinter.yaml'" --remove-container
+CLOJURE_TEST_RUNNER = clojure -M:test/env:test/run
+CLOJURE_EXEC_TEST_RUNNER = clojure -X:test/env:test/run
+
+# Makefile file and directory name wildcard
+# EDN-FILES := $(wildcard *.edn)
+# ------------------------------------ #
+
+# ------- Help ----------------------- #
+# Source: https://nedbatchelder.com/blog/201804/makefile_help_target.html
+
+help:  ## Describe available tasks in Makefile
+	@grep '^[a-zA-Z]' $(MAKEFILE_LIST) | \
+	sort | \
+	awk -F ':.*?## ' 'NF==2 {printf "\033[36m  %-$(HELP-DESCRIPTION-SPACING)s\033[0m %s\n", $$1, $$2}'
+# ------------------------------------ #
+
+# ------- Clojure Development -------- #
+repl:  ## Run Clojure REPL with rich terminal UI (Rebel Readline)
+	$(info --------- Run Rebel REPL ---------)
+	clojure -M:test/env:repl/reloaded
+
+deps: deps.edn  ## Prepare dependencies for test and dist targets
+	$(info --------- Download test and service libraries ---------)
+	clojure -P -X:build
+
+dist: build-uberjar ## Build and package Clojure service
+	$(info --------- Build and Package Clojure service ---------)
+
+install: build-jar
+	$(info --------- install library jar ---------)
+	clojure -T:build install
+
+deploy: build-jar
+	$(info --------- install library jar ---------)
+	clojure -T:build deploy
+
+publish: build-jar
+	$(info --------- Build and Package Clojure lib ---------)
+
+# Remove files and directories after build tasks
+# `-` before the command ignores any errors returned
+clean:  ## Clean build temporary files
+	$(info --------- Clean Clojure classpath cache ---------)
+	- rm -rf ./.cpcache ./.clj-kondo ./.lsp
+# ------------------------------------ #
+
+# ------- Testing -------------------- #
+test-config:  ## Print Kaocha test runner configuration
+		$(info --------- Runner Configuration ---------)
+		$(CLOJURE_TEST_RUNNER) --print-config
+
+test-profile:  ## Profile unit test speed, showing 3 slowest tests
+		$(info --------- Runner Profile Tests ---------)
+		$(CLOJURE_TEST_RUNNER) --plugin  kaocha.plugin/profiling
+
+test:  ## Run unit tests - stoping on first error
+		$(info --------- Runner for unit tests ---------)
+		$(CLOJURE_EXEC_TEST_RUNNER)
+
+test-all:  ## Run all unit tests regardless of failing tests
+		$(info --------- Runner for all unit tests ---------)
+		$(CLOJURE_EXEC_TEST_RUNNER) :fail-fast? false
+
+test-watch:  ## Run tests when changes saved, stopping test run on first error
+		$(info --------- Watcher for unit tests ---------)
+		$(CLOJURE_EXEC_TEST_RUNNER) :watch? true
+
+test-watch-all:  ## Run all tests when changes saved, regardless of failing tests
+		$(info --------- Watcher for unit tests ---------)
+		$(CLOJURE_EXEC_TEST_RUNNER) :fail-fast? false :watch? true
+# ------------------------------------ #
+
+# -------- Build tasks --------------- #
+build-config: ## Pretty print build configuration
+	$(info --------- View current build config ---------)
+	clojure -T:build config
+
+build-jar: ## Build a jar archive of Clojure project
+	$(info --------- Build library jar ---------)
+	clojure -T:build jar
+
+build-uberjar: ## Build a uberjar archive of Clojure project & Clojure runtime
+	$(info --------- Build service Uberjar  ---------)
+	clojure -T:build uberjar
+
+build-clean: ## Clean build assets or given directory
+	$(info --------- Clean Build  ---------)
+	clojure -T:build clean
+# ------------------------------------ #
+
+# ------- Code Quality --------------- #
+pre-commit-check: format-check lint test  ## Run format, lint and test targets
+
+format-check: ## Run cljstyle to check the formatting of Clojure code
+	$(info --------- cljstyle Runner ---------)
+	cljstyle check
+
+format-fix:  ## Run cljstyle and fix the formatting of Clojure code
+	$(info --------- cljstyle Runner ---------)
+	cljstyle fix
+
+lint:  ## Run MegaLinter with custom configuration (node.js required)
+	$(info --------- MegaLinter Runner ---------)
+	$(MEGALINTER_RUNNER)
+
+lint-fix:  ## Run MegaLinter with applied fixes and custom configuration (node.js required)
+	$(info --------- MegaLinter Runner ---------)
+	$(MEGALINTER_RUNNER) --fix
+
+lint-clean:  ## Clean MegaLinter report information
+	$(info --------- MegaLinter Clean Reports ---------)
+	- rm -rf ./megalinter-reports
+# ------------------------------------ #
+
+# ------- Docker Containers ---------- #
+docker-build:  ## Build Clojure project and run with docker compose
+	$(info --------- Docker Compose Build ---------)
+	docker compose up --build --detach
+
+docker-build-clean:  ## Build Clojure project and run with docker compose, removing orphans
+	$(info --------- Docker Compose Build - remove orphans ---------)
+	docker compose up --build --remove-orphans --detach
+
+docker-down:  ## Shut down containers in docker compose
+	$(info --------- Docker Compose Down ---------)
+	docker compose down
+
+swagger-editor:  ## Start Swagger Editor in Docker
+	$(info --------- Run Swagger Editor at locahost:8282 ---------)
+	docker compose -f swagger-editor.yml up -d swagger-editor
+
+swagger-editor-down:  ## Stop Swagger Editor in Docker
+	$(info --------- Run Swagger Editor at locahost:8282 ---------)
+	docker compose -f swagger-editor.yml down
+# ------------------------------------ #
+
+# ------ Continuous Integration ------ #
+# .DELETE_ON_ERROR: halts if command returns non-zero exit status
+# https://makefiletutorial.com/#delete_on_error
+
+# TODO: focus runner on ^:integration` tests
+test-ci: deps  ## Test runner for integration tests
+	$(info --------- Runner for integration tests ---------)
+	clojure -P -X:test/env:test/run
+
+# Run tests, build & package the Clojure code and clean up afterward
+# `make all` used in Docker builder stage
+.DELETE_ON_ERROR:
+all: test-ci dist clean  ## Call test-ci dist and clean targets, used for CI
+# ------------------------------------ #

README.md

@@ -0,0 +1 @@
+# 

dev/mulog_events.clj

@@ -0,0 +1,55 @@
+;; ---------------------------------------------------------
+;; Mulog Global Context and Custom Publisher
+;;
+;; - set event log global context
+;; - tap publisher for use with Portal and other tap sources
+;; - publish all mulog events to Portal tap source
+;; ---------------------------------------------------------
+
+(ns mulog-events
+  (:require
+   [com.brunobonacci.mulog        :as mulog]
+   [com.brunobonacci.mulog.buffer :as mulog-buffer]))
+
+;; ---------------------------------------------------------
+;; Set event global context
+;; - information added to every event for REPL workflow
+(mulog/set-global-context! {:app-name "playground Service",
+                            :version "0.1.0", :env "dev"})
+;; ---------------------------------------------------------
+
+;; ---------------------------------------------------------
+;; Mulog event publishing
+
+(deftype TapPublisher
+         [buffer transform]
+  com.brunobonacci.mulog.publisher.PPublisher
+  (agent-buffer [_] buffer)
+  (publish-delay [_] 200)
+  (publish [_ buffer]
+    (doseq [item (transform (map second (mulog-buffer/items buffer)))]
+      (tap> item))
+    (mulog-buffer/clear buffer)))
+
+#_{:clj-kondo/ignore [:unused-private-var]}
+(defn ^:private tap-events
+  [{:keys [transform] :as _config}]
+  (TapPublisher. (mulog-buffer/agent-buffer 10000) (or transform identity)))
+
+(def tap-publisher
+  "Start mulog custom tap publisher to send all events to Portal
+  and other tap sources
+  `mulog-tap-publisher` to stop publisher"
+  (mulog/start-publisher!
+   {:type :custom, :fqn-function "mulog-events/tap-events"}))
+
+#_{:clj-kondo/ignore [:unused-public-var]}
+(defn stop
+  "Stop mulog tap publisher to ensure multiple publishers are not started
+ Recommended before using `(restart)` or evaluating the `user` namespace"
+  []
+  tap-publisher)
+
+;; Example mulog event message
+;; (mulog/log ::dev-user-ns :message "Example event message" :ns (ns-publics *ns*))
+;; ---------------------------------------------------------

dev/portal.clj

@@ -0,0 +1,24 @@
+(ns portal
+  (:require
+   ;; Data inspector
+   [portal.api :as inspect]))
+
+
+;; ---------------------------------------------------------
+;; Start Portal and capture all evaluation results
+
+;; Open Portal window in browser with dark theme
+;; https://cljdoc.org/d/djblue/portal/0.37.1/doc/ui-concepts/themes
+;; Portal options:
+;; - light theme {:portal.colors/theme :portal.colors/solarized-light}
+;; - dark theme  {:portal.colors/theme :portal.colors/gruvbox}
+
+(def instance
+  "Open portal window if no portal sessions have been created.
+   A portal session is created when opening a portal window"
+  (or (seq (inspect/sessions))
+      (inspect/open {:portal.colors/theme :portal.colors/gruvbox})))
+
+;; Add portal as tapsource (add to clojure.core/tapset)
+(add-tap #'portal.api/submit)
+;; ---------------------------------------------------------

dev/user.clj

@@ -0,0 +1,107 @@
+;; ---------------------------------------------------------
+;; REPL workflow development tools
+;;
+;; Include development tool libraries vai aliases from practicalli/clojure-cli-config
+;; Start Rich Terminal UI REPL prompt:
+;; `clojure -M:repl/reloaded`
+;;
+;; Or call clojure jack-in from an editor to start a repl
+;; including the `:dev/reloaded` alias
+;; - alias included in the Emacs `.dir-locals.el` file
+;; ---------------------------------------------------------
+
+
+(ns user
+  "Tools for REPL Driven Development"
+  (:require
+   ;; REPL Workflow
+   [mulog-events]                      ; Event Logging
+   [com.brunobonacci.mulog :as mulog]  ; Global context & Tap publisher
+   [portal]
+   [portal.api :as inspect]                          ; Data inspector
+   [clojure.tools.namespace.repl :as namespace]))
+
+;; ---------------------------------------------------------
+;; Help
+
+(println "---------------------------------------------------------")
+(println "Loading custom user namespace tools...")
+(println "---------------------------------------------------------")
+
+(defn help
+  []
+  (println "---------------------------------------------------------")
+  (println "Namesapece Management:")
+  (println "(namespace/refresh)            ; refresh all changed namespaces")
+  (println "(namespace/refresh-all)        ; refresh all namespaces")
+  (println)
+  (println "Hotload libraries:             ; Clojure 1.12.x")
+  (println "(add-lib 'library-name)")
+  (println "(add-libs '{domain/library-name {:mvn/version \"v1.2.3\"}})")
+  (println "(sync-deps)                    ; load dependencies from deps.edn")
+  (println "- deps-* lsp snippets for adding library")
+  (println)
+  (println "Portal Inspector:")
+  (println "- portal started by default, listening to all evaluations")
+  (println "(inspect/clear)                ; clear all values in portal")
+  (println "(remove-tap #'inspect/submit)  ; stop sending to portal")
+  (println "(inspect/close)                ; close portal")
+  (println)
+  (println "(help)                         ; print help text")
+  (println "---------------------------------------------------------"))
+
+(help)
+
+;; End of Help
+;; ---------------------------------------------------------
+
+;; ---------------------------------------------------------
+;; Avoid reloading `dev` code
+;; - code in `dev` directory should be evaluated if changed to reload into repl
+(println
+ "Set REPL refresh directories to "
+ (namespace/set-refresh-dirs "src" "resources"))
+;; ---------------------------------------------------------
+
+;; ---------------------------------------------------------
+;; Mulog event logging
+;; `mulog-publisher` namespace used to launch tap> events to tap-source (portal)
+;; and set global context for all events
+
+;; Example mulog event message
+(mulog/log ::dev-user-ns
+           :message "Example event from user namespace"
+           :ns (ns-publics *ns*))
+;; ---------------------------------------------------------
+
+;; ---------------------------------------------------------
+;; Hotload libraries into running REPL
+;; `deps-*` LSP snippets to add dependency forms
+(comment
+  ;; Require for Clojure 1.11.x and earlier
+  (require '[clojure.tools.deps.alpha.repl :refer [add-libs]])
+  (add-libs '{domain/library-name {:mvn/version "1.0.0"}})
+
+  ;; Clojure 1.12.x only
+  #_(add-lib 'library-name)   ; find and add library
+  #_(sync-deps)               ; load dependencies in deps.edn (if not yet loaded)
+  #_()) ; End of rich comment
+;; ---------------------------------------------------------
+
+;; ---------------------------------------------------------
+;; Portal Data Inspector
+(comment
+  ;; Open a portal inspector in browser window - light theme
+  ;; (inspect/open {:portal.colors/theme :portal.colors/solarized-light})
+
+  (inspect/clear) ; Clear all values in portal window (allows garbage collection)
+
+  (remove-tap #'inspect/submit) ; Remove portal from `tap>` sources
+
+  (inspect/close) ; Close the portal window
+
+  (inspect/docs) ; View docs locally via Portal
+
+  #_()) ; End of rich comment
+
+;; ---------------------------------------------------------

tests.edn

@@ -0,0 +1,13 @@
+;; ---------------------------------------------------------
+;; Kaocha test runner configuration
+;;
+;; Default configuration
+;; - show current config using either command:
+;;
+;; make test-config
+;;
+;; clojure -M:test/env:test/run --print-config
+
+;; ---------------------------------------------------------
+
+#kaocha/v1 {}