Frequently Asked Questions

How do I get dependencies from Clojars?

To get dependencies from anywhere you need to list it in your project’s repositories block.

// plugins, etc.

repositories {
  maven {
    name = 'Clojars'
    url = 'https://repo.clojars.org/'
  }
}

// dependencies, etc.

How do I publish to Clojars?

You’ll want to set your Clojars credentials in environment variables (in this example, CLOJARS_USER and CLOJARS_PASSWORD).

plugins {
  id 'maven-publish'
}

// other stuff

publishing {
  publications {
    main(MavenPublication) {
      from components.java
    }
  }
  repositories {
    maven {
      name = 'clojars'
      url = 'https://repo.clojars.org'
      credentials {
        username = System.env['CLOJARS_USER']
        password = System.env['CLOJARS_PASSWORD']
      }
    }
  }
}

Then run the publish task.

How do I create an uberjar?

Use the Gradle Shadow plugin.

Configuration

To create an executable uberjar:

plugins {
  id 'dev.clojurephant.clojure' version '<version>'
  // this tells Gradle you're generating an application with a main class
  id 'application'
  // Pulls in the shadow plugin which produces the uberjar
  id 'com.github.johnrengelman.shadow' version '6.1.0'
}

mainClassName = 'whatever_your.main.ns.class.is'

// normal repositories and deps blocks

Ensure your main namespace has (:gen-class) in the ns declaration:

(ns sample.core
  (:require [clojure.string :as string]
            [java-time :as time])
  (:gen-class))

(defn -main [& args]
  (println (str (time/local-date))))

Usage

More information

Read the Shadow Plugin User Guide. for full details on their other features.

How do I use CIDER?

CIDER is a Clojure development environment for Emacs.

Right now you need to manually add the dependency and specify the handler/middleware.

Either apply to all of your projects via an init script:

~/.gradle/init.d/cider.gradle

allprojects {
  plugins.withId('dev.clojurephant.clojure') {
    dependencies {
      devImplementation 'cider:cider-nrepl:0.25.6'
    }

    clojureRepl {
      handler = 'cider.nrepl/cider-nrepl-handler'
    }
  }
}

Or add it manually to your project:

build.gradle

dependencies {
  devImplementation 'cider:cider-nrepl:0.25.16
}

clojureRepl {
  handler = 'cider.nrepl/cider-nrepl-handler'
}

Optionally, omit the handler config and provide it on the CLI:

./gradlew clojureRepl --handler=cider.nrepl/cider-nrepl-handler

Once your REPL starts, use cider-connect within Emacs to connect to the port listed in your Gradle output.

How do I build Clojure code that depends on Java code?

You can compile Clojure code that depends on Java out of the box. Just put your Java code in the same source set as the Clojure code:

<project>/
  src/
    main/
      java/
        sample_java/
          Sample.java
      clojure/
        sample_clojure/
          core.clj

How do I build Java code that depends on Clojure code?

This requires introducing another source set for the Clojure code.

<project>/
  src/
    main/
      java/
        sample_java/
          Sample.java
    pre/
      clojure/
        sample_clojure/
          core.clj

build.gradle

// plugins, etc...

sourceSets {
  pre
  main.compileClasspath += pre.output
}

configurations {
  preImplementation.extendsFrom implementation
}

// dependencies, etc...

NOTE: you could be more thorough in your configuration to get all of the configurations to line up consistently, but this covers the main use case.