https://github.com/clojure/build.poms

Parent POMs
https://github.com/clojure/build.poms

Last synced: 3 months ago
JSON representation

Parent POMs

• Host: GitHub
• URL: https://github.com/clojure/build.poms
• Owner: clojure
• Created: 2010-10-28T19:17:48.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2024-07-15T18:03:10.000Z (6 months ago)
• Last Synced: 2024-09-29T17:21:48.032Z (3 months ago)
• Homepage: http://clojure.org
• Size: 82 KB
• Stars: 8
• Watchers: 27
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
org.clojure parent POMs

========================================

This project defines a parent Maven Project Object Model (POM) for

projects contributed to Clojure and built at

[build.clojure.org](http://build.clojure.org).

What does this POM do?

========================================

The pom.xml file of this project defines a common configuration

baseline for libraries contributed to Clojure, including:

* Build properties

  * `clojure.version` defined to be the most recent release of Clojure

    * This may be an alpha or beta release

    * This may be changed on the Maven command line to test with different versions

  * `clojure.warnOnReflection` sets the `*warn-on-reflection*` flag during compilation

    * Defaults to false

    * This may be changed on the Maven command line to test with `*warn-on-reflection*` true

  * `project.build.sourceEncoding` set to UTF-8

* License set to EPL 1.0

* Build plugin configuration

  * build-helper-maven-plugin

    * Adds src/main/clojure to the source and resource directories for the project

    * Adds src/test/clojure to the test source and test resource directories for the project

    * Ensures sources will be recognized by other plugins and copied to the output JAR

  * com.theoryinpractise:clojure-maven-plugin

    * AOT-compiles all .clj sources as a syntax check

    * Does *not* include any AOT-compiled .class files in the output JAR

    * Runs tests defined with clojure.test

    * Does *not* AOT-compile test .clj sources

  * maven-compiler-plugin

    * Sets Java source and target version to 1.9

    * Sets Java source file encoding to UTF-8

  * maven-release-plugin

    * Prevents tags and other changes from being pushed to Git when a release build fails

  * nexus-staging-maven-plugin

    * Deploy to Nexus repo (in this case, the sonatype repo)

  * maven-gpg-plugin

    * Sign artifacts prior to deployment 

* Dependencies

  * Adds dependency on a Clojure release defined by the `clojure.version` property

What do contrib projects need to do?

========================================

Unless they have special build requirements such as `gen-class`,

contrib projects should only require three things:

* Clojure sources in `src/main/clojure/`

* Test sources using clojure.test in `src/test/clojure/`

* A pom.xml file that looks like example-project-pom.xml