Make your Clojure library build process easy.

Note	This project is alpha version. Breaking changes may happen

Table of Contents

build.edn make you buildable your libraries only preparing build.edn file for the simple usage.

• build.edn

  • {:lib com.github.YOUR-ACCOUNT/AWESOME-LIB
     :version "0.1.{{git/commit-count}}"}

• deps.edn

  • {:aliases
     {:build {:deps {com.github.liquidz/build.edn {:git/tag "0.2.63" :git/sha "f4e571d"}}
              :ns-default build-edn.main}}}

• use by clojure cli

  • # Install lib to your local maven repo
    $ clojure -T:build install
    
    # Deploy to clojars.org
    # CLOJARS_USERNAME and CLOJARS_PASSWORD environmental variables are required
    $ clojure -T:build deploy

Function	Description
pom	Generate pom.xml
jar	Generate JAR file
uberjar	Generate standalone JAR file
install	Install to local Maven repository
deploy	Deploy to https://clojars.org
update-documents	Update document files for new release

name	type	required?	default	description
lib	qualified-symbol?	Yes
version	string?	Yes
source-dir	string?		Your paths in deps.edn
class-dir	string?		"target/classes"
jar-file	string?		"target/{{lib}}.jar"
uber-file	string?		"target/{{lib}}-standalone.jar"	Required only for uberjar
main	symbol?			Required only for uberjar
scm	map?			You can generate pom.xml with scm section. name type connection string? developerConnection string? url string?
documents	sequential?			Required only for update-documents name type file string? match string? action enum :append-before, :replace, :append-after text string?
github-actions?	boolean?		false	See GitHub Actions section below for more information

Name	Available parameters	Description
{{git/commit-count}}	version, text in documents
{{git/head-long-sha}}	version, text in documents
{{git/head-short-sha}}	version, text in documents
{{now/yyyy}}	version, text in documents	year-of-era
{{now/mm}}	version, text in documents	month-of-year
{{now/m}}	version, text in documents	month-of-year
{{now/dd}}	version, text in documents	day-of-month
{{now/d}}	version, text in documents	day-of-month
{{version}}	text in documents
{{lib}}	jar-file, uber-file

When you set true to :github-actions?, build.edn will set following outputs.

Of course, build.edn itself is using build.edn for releasing.

• liquidz/antq

• liquidz/merr

• liquidz/testdoc

• liquidz/rewrite-indented

Copyright © 2022 Masashi Iizuka

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.