/la-clojure

Clojure plugin for IntelliJ IDEA

Primary LanguageJava

la-clojure

Clojure plugin for IntelliJ IDEA.
Provides Clojure language support: syntax and error highlighting, completion, navigation and refactorings.

Getting Started

You have decided to develop in Clojure with your favorite IDE. Great! This README will assume that you have already downloaded and installed the "la-clojure" plugin via "Settings -> Plugins".

If you are familiar with Clojure, your first intuition will be to try to open a REPL in the IDE. However, before you do that, you must first create a Clojure project.

This README assumes that you already have a JDK installed.

  1. Click "File -> New Project -> Create Project from Scratch".
  2. Enter a name for your project, and select "Java Module" as the type. Click "Next".
  3. Create a new source directory (or not) and click "Next".
  4. In the "Desired technologies" list check the "Clojure" checkbox. You can choose to "Download" the Clojure jar (version 1.2) or select "Set up library later" to specify your own version of clojure.jar.
  5. Click "Finish" and the project will be created.

If you selected "Set up library later", configure the library as below:

  1. Download the latest version of the Clojure jar from clojure.org
  2. Right click on the project to "Open Module Settings"
  3. Click on "Modules -> Dependencies".
  4. Click "Add -> Single Entry Module Library", and select the path where you downloaded clojure.jar to.
  5. Click "Apply" and "OK".

Now you can start a Clojure Console via "Tools -> Clojure Console" or "Ctrl+Shift+F10".

Develop (Clojure) with Pleasure!

Release cycle

Master branch is compatible only with IDEA 13. We are planning to update builds to plugins site for every IDEA 13 EAP, which breaks compatibility and at the beggining of every month.

We don't use GitHub issue tracker, so all issues from here will be moved to our main issure tracker.

We also started nighlty builds.

If you have any questions related to this project, use our Developer Forum.

Setting up "La Clojure" project

Follow these steps:

  1. Clone this repository.
  2. Create 'IDEA13SDK' directory (or symlink) in folder 'lib'
  3. Download archive of the latest IDEA 13 EAP Ultimate or Community edition. Note, that for Windows and COmmunity edition you need to download installer.
  4. Unpack it into 'IDEA13SDK' directory (or symlink), 'bin' directory should be in the root.
  5. Open 'La Clojure' project now
  6. Setup JDK. Additionally add tools.jar, from jdk lib directory. It contains JDI classes.
  7. Now you can compile and run IDEA run configuration.
  8. To build plugin, run 'Production' artifact from IDEA (Build -> Build Artifacts)
  9. To attach IDEA sources you need to create sources.zip file (and put it to 'IDEA13SDK' directory) with the following structure: community/java, community/platform and so on (from plugins sources you need only copyright plugin).
  10. To run tests use 'AllTests' run configuration. To run single test, configure defaults for JUnit configuration like it's done in 'AllTests' run configuration.