Intellij project creation notes
Jython is an Ant project. This makes it a bit difficult to import into Intellij IDEA. This step by step guide should help you to get started.
Software packages (outside Intellij)
- Java JDK
- Python 2.7
Intellij IDEA 12 (http://www.jetbrains.com/idea/)
There is a free "Community Edition" of Intellij that might work (I'm only unsure about the Python integration). However as I (SvenDehmlow) use the Ultimate Edition, this tutorial is tested with this edition.
Intellij offers free IDEA licenses for Open Source projects. Perhaps it might be a good idea to apply for them.
- Ant Support (Bundled)
- Eclipse Integration (Bundled)
- hg4idea (Bundled)
- Python (Custom, i.e. must be installed from Intellij plugin repository)
Of course there are many other useful plugins, but these four are essential for importing Jython into Intellij IDEA.
Make a clean checkout
1 hg clone http://bitbucket.org/jython/jython jython
Remove Intellij files from jython
Unfortunately the Intellij project files in the jython source directory don't work (anymore?). We'll delete them. Later Intellij IDEA will create new ones for us.
Change into the jython directory:
1 cd jython
Run this in the jython source directory (if you made the previous step, you're already there):
Import jython as Eclipse-Project in Intellij IDEA
Start Intellij IDEA. Close the last open project (if there's any), to get to the start screen.
Choose Import Project:
Select jython source directory:
Import project from external model --> Eclipse:
Check Link created Intellij IDEA modules to Eclipse project files. For other fields the defaults should be sufficient.
Drag and drop the ant build.xml from the project window to the ant window. This will make Intellij aware of the ant project.
If you've configured more than one SDK for Python oder Java in Intellij IDEA, you should open the Project Structure (Shortcut: Strg + Alt + Shift + s) and check that the right SDKs are used for Jython.
I think a JDK >= 6 and CPython corresponting to the current Jython version (2.7) are good guesses.
InformixDataHandler and OracleDataHandler
If you're going to work in the area of JDBC data handlers, figure from build.xml out which jars you'll need (one for Infromix and one for Oracle), download them and put them into the extlibs directory.
Build the project to see, if everything went well. For this either use Build --> Make Project in the menu or the shortcut Ctrl + F9.
What did we?
Speaking in Intellij jargon, we adopted the whole Project Structure (classpath, source and test directories, libaries) from the Eclipse project files. We could have done this manually, but this way was much easier and less error-prone.
It's a good idea to take a look at the Project Structure (Shortcut: Ctrl + Alt + Shift + s) as e.g. the classpath might change with the next update.