A proxy to library for building artifacts in Clojure projects.

cljs compiler toolings. Use shadow on npx.

Proxy to [npx](https://shadow-cljs.github.io/docs/UsersGuide.html#_command_line)

Access code files.

Search for some (forbidden) keywords in the project code.

Format code to apply rules in `zprintrc`.

Proxy to [zprint](https://github.com/kkinnear/zprint)

Lint the application.

Proxy to [clj-kondo](https://github.com/clj-kondo/clj-kondo?tab=readme-ov-file#usage) 

Reports analyzing the clojure code.

Version Control System.

Proxy to [git](https://git-scm.com/book/en/v2).

Utility functions for keywords.

Useful map utilities

Validate the data against the schema.

Proxy to [malli](https://github.com/metosin/malli).

Create mermaid images.

Proxy to [mermaid cli](https://www.npmjs.com/package/@mermaid-js/mermaid-cli)

Echoing in terminal for long living and possibly parrallel actions (like REPL and so on.).

Each line is prefixed with the name of the concerned action.

Common functions for echoing. Don't use this namespace but one of the implementation of echoing, like headers or actions.

Prints text with headers on the terminal.

Each content is modified to wrap the `width` of the terminal, and is modified to have a left margin.

Load the file css.

Proxy to [tailwindcss](https://tailwindcss.com/docs/installation).

Creates an html page to redirect to another page.

A project map for a monorepo with subprojects.

Parse cli options.

Proxy to [tools.cli](https://github.com/clojure/tools.cli)

Execute commands.

Adapter to read an edn file.

Constants to have clear and consistent return codes for the application

Tools to manipulate local files

Is a proxy to babashka.fs tools.

Manipulate file names (is not influenced at all by your local configuration).

Everything about json manipulation

Colorize text. The reference comes from:
[ANSI reference sheet](https://gist.github.com/ConnerWill/d4b6c776b509add763e17f9f113fd25b)
and full reference is [vt100 spec](https://vt100.net/docs/vt100-ug/chapter3.html).

Return system wide user informations.

Version of the current codebase

* Version is based on a root project file named `version.edn`.
Strengths:
* One source of truth for version.
* Change of version in a PR is more straightforward to notice
* Flexibility (We don't decide on versioning strategy, we just have file that is point of reference to what version you are on.)
Constraints:
 * Keeping up with updates for version files (although with automated tooling we have, it is not that big of a deal currently)

Previous design:
* major version has to be changed in the major-version in `build_config.edn` (many sources of truth and build_config shouldn't be a place that is used as variable that change often)
* counting commits from a branch to base a minor version on it (Many edgecases where commits don't match the version, initial commits, PRs having more than one commit...)

Loads `project` configuration file.

Configuration parameters, stored in configuration file.
This namespace is the entry point to call conf

Managing project dependencies versions

Project `deps.edn` file.

Code here is regarding all interactions with clever cloud.
Design decision:
Interaction with clever cloud is by using git.

Alternatively it could be done by using clever CLI, but currently we don't need any features that can't be done by simply manipulating the repository in the git. Which is a simpler option in terms of complexity (no need for API to check), while still being flexible (a lot of options to manipulate in git). Additionally this doesn't require to install the clever cloud cli.

Proxy to antq library

Simple configuration based on files
Data can be set in java property `heph-conf`, if more files are needed you can pass them separated by `,`

Github yml workflow file

The project map gathers all useful informations for a project

Shadow-cljs.edn proxy.

Code related to app versioning, holds current strategy for versioning

Workflow 2 is starting a local development environment

Quick code check.

Prepare project for proper commit.

All common workflow features.

Manages container.
Proxy to docker technology

Task for managing outdated dependencies

Publish documentation.

Proxy to [codox](https://github.com/weavejester/codox?tab=readme-ov-file).

Diagnoses common issue on the monorepo.

Wrap command functions with action echoing.

In a workflow, commit.

Load deps edn with headers logs.

Read files with headers log.

Echo error message for shadow file manipulation.

In a workflow, lint a project.

Report aliases inconsistency:
* One `ns` with more than one alias,
* One `alias` assigned to more than one namespace..

Common reporting features.

Scan code files for forbidden words.

The forbidden words ca be setup in the `project.edn` under the `[:code :forbidden-words]`

It will report whatever word is set this project.edn, except infiles which first line is:
#":heph-ignore\s*\{[^\}]*:forbidden-words".

that will ignore `forbidden-words`.