main entry point for code.manage

(code.manage/-main “import” “xyz.zcaudate” “{:tag :all}”)

analyse either a source or test file

(analyse ’code.manage) ;;#code{:test {code.manage analyse …. vars}} => code.framework.common.Entry

(analyse ’#{code.manage} {:return :summary}) ;; {:errors 0, :warnings 0, :items 1, :results 1, :total 16} => map?

arranges the test corresponding to function order

(arrange {:print {:function false} :write false})

(arrange ’code.manage {:print {:item true} :write false})

returns tests that are in comment blocks

(commented)

(commented ’code.manage)

creates and arranges the tests

returns docstrings

(docstrings ’#{code.manage.unit} {:return :results}) ;;{:errors 0, :warnings 0, :items 1, :results 1, :total 14} => map?

returns the list of vars in a namespace

(vars ’code.manage)

(vars ’code.manage {:sorted false})

(vars ’#{code.manage} {:return #{:errors :summary}}) => (contains-in {:errors any :summary {:errors 0 :warnings 0 :items 1 :results 1 :total number?}})

regenerates => expectations for fact tests

(factcheck-generate {:write false})

(factcheck-generate ’code.manage {:print {:item true} :write false})

removes => expectations from fact tests

(factcheck-remove {:write false})

(factcheck-remove ’code.manage {:print {:item true} :write false})

find usages of a var

(find-usages ’code.manage {:var ’code.framework/analyse})

finds a string or regular expression in files

(grep ’code.manage {:query “hello”})

grep and replaces in files

(grep-replace ’code.manage {:query “hello” :replace “HELLO”})

helper function for any arbitrary transformation of text

(transform-code {:transform #(str % “\n\n\n\nhello world”)}) ;; {:deletes 0, :inserts 5, :changed arrange, :updated false} => map?

(transform-code ’#{code.manage.unit} {:print {:summary true :result true :item true :function true} :transform #(str % “\n\n\n\nhello world”) :full true})

import docstrings from tests

(import {:write false})

(import {:examples true :write false})

(import {:full true :write false :print {:function false}})

(import ’code.manage.unit {:print {:summary true :result true :item true} :write false})

checks if tests are in order

(in-order?)

(in-order? ’code.manage {:print {:item true}})

both functions missing tests or tests with todos

(incomplete)

(incomplete ’code.manage {:print {:item true}})

writes a versioned incomplete-test report for one configured CI section

copies failing facts from a run report into a new test namespace

(code.manage/isolate xt.lang.spec-base-test {:run “.hara/runs/run-1776913569354.edn” :suffix “-fix” :print {:item true :result true :summary true}})

locates code base upon query

locates test based upon query

checks for functions with missing tests

(missing)

(missing ’platform {:print {:result false :summary false} :return :all})

formats ns forms

top-level ns rename function

tests without corresponding source code

(orphaned)

(orphaned ’code.manage {:print {:item true}})

returns tests that may be improved

(pedantic)

(pedantic ’code.manage)

removes docstrings from source code

(purge {:write false})

(purge {:full true :write false})

(purge ’platform.unit {:return :summary :write false}) ;;{:items 38, :results 32, :deletes 1272, :total 169} => map?

refactors code based on given :edits

(refactor-code ’code.manage {:edits []})

refactors by providing a list of symbols to swap

refactors code tests based on given :edits

requires the file and returns public vars

(require-file ’code.manage) => (contains ’analyse extract …)

creates a scaffold for a new or existing set of tests

(scaffold {:write false})

(scaffold ’code.manage {:print {:item true} :write false})

formats fact tests into snap-to layout

(snapto {:write false})

(snapto ’code.manage {:print {:item true} :write false})

checks for tests with TODO as docstring

(todos)

(todos ’platform {:print {:result false :summary false} :return :all})

helper function for any arbitrary transformation of text

(transform-code {:transform #(str % “\n\n\n\nhello world”)}) ;; {:deletes 0, :inserts 5, :changed arrange, :updated false} => map?

(transform-code ’#{code.manage.unit} {:print {:summary true :result true :item true :function true} :transform #(str % “\n\n\n\nhello world”) :full true})

returns tests without => checks

(unchecked)

(unchecked ’code.manage)

finds source code that has top-level comments

(unclean ’code.manage)

(unclean ’hara)

returns the list of vars in a namespace

(vars ’code.manage)

(vars ’code.manage {:sorted false})

(vars ’#{code.manage} {:return #{:errors :summary}}) => (contains-in {:errors any :summary {:errors 0 :warnings 0 :items 1 :results 1 :total number?}})