lucene-solr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Solr Wiki] Update of "HowToContribute" by ErickErickson
Date Sun, 25 Apr 2010 19:05:05 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Solr Wiki" for change notification.

The "HowToContribute" page has been changed by ErickErickson.
The comment on this change is: Expanded IntelliJ setup notes.
http://wiki.apache.org/solr/HowToContribute?action=diff&rev1=44&rev2=45

--------------------------------------------------

  See: http://www.lucidimagination.com/developers/articles/setting-up-apache-solr-in-eclipse.
  
  == IntelliJ (Maia-IU-95.24) ==
+ === Cheap, easy way to get basic functionality running ===
  In a word, cheat. Follow the instructions above to get the source code AND copy the Eclipse
.project and .classpath files to the Lucene and SOLR directories. Yes, the Eclipse ones. But
you do NOT need to open Eclipse or make any Eclipse projects, just have the .project and .classpath
files in the right place.
  
  Fire up IntelliJ and click "create new project>>import project from external model
(Eclipse)" and click some "next" buttons until the new projects dialog appears. In the "Select
Eclipse directory" textbox, navigate to ~/apache/trunk/lucene". I just let the defaults stay
"Create module near .classpath files" Project File Format is ".idea (directory based). Now
click through until you get to a "finish" button and wait a bit.
  
  You should now be able to run tests by finding a test file, crtl-click (right click) on
a test file and "run". IntelliJ seems to figure out that it's a junit test.
  
- Note: I'm having some trouble executing some of the tests, for instance TestPorterStemFilter
can't find porterTestData.zip. This file exists as a sibling to the test file, I won't have
time to try to figure out why for a couple of days. I'm almost entirely sure I need to set
some path in IntelliJ, anyone want to jump in here and figure it out for me?
+ Note: Out of the box, testPorterStemFilter fails with the error "cannot find porterTestData.zip".
Apparently, the test that calls for this file is looking for org/apache/lucne/analysis/porterTestData.zip
and can't find it. You can solve this (and, I assume related issues) by specifying a "library"
and clicking the "attach jar directories", then point it at ~/apache/trunk/lucene/src/test".
Now make your module rely on the new library. 
  
  Then I did the same thing for SOLR, *except* I created a new "module" rather than "project".
The first JUnit test I ran worked perfectly.
  
@@ -253, +254 @@

  
  I haven't tried to set up SOLR to run from within IntelliJ yet, if anyone has feel free
to add the instructions.
  
+ === More flexible setup without using Eclipse .project files ===
+ 
+ This turns out not to be too bad, but tedious. Cheating by using the Eclipse files kinda
works, but then you're stuck with all of the contrib packages, etc. Here's a general outline.
I'll expand it if the dev list (which I (Erick Erickson) monitor) shows that there's enough
interest... 
+ 
+ Instead of an "all at once" setup, I created a series of modules, for instance "lucene",
"lucene_test" etc. You can group them any way you want (IntelliJ has a "Move Module to Group"
option). So my structure looks like this:
+ 
+ {{{
+  Lucene
+  Lucene_test
+  contrib (group)
+    highlight
+    memory
+    queryparser
+ }}}
+ 
+ After you've gotten the source code, you can set up various modules and create groups, moving
things around by the context-menu choices. By and large, the trick is to then make each module
dependent on other modules as needed, as well as on the main Lucene library in ~/apache/trunk/lucene/lib
that contains the jars for junit, ant, etc.
+ 
+ So, first "create new module from existing source" for, say, Lucene. In this setup, I created
it from the source at ~/apache/trunk/lucene/src/java This gives the starter kit. Then I created
the "Lucene_Test" module, but now you have no choice to "create from source", instead you
just choose "create module from scratch", but then navigate to the source at ~/apache/trunk/lucene/src/test.
Set up a library to point to ~/apache/trunk/lucene/lib. Make both the modules depend on this
library, and additionally make the Lucene_Test module depend on the Lucene module (see the
"module settings>>dependencies" tab). You should now be able to get the test cases to
run. See the note above about how to find resources, e.g. "porterTestData.zip". I haven't
run all the tests from inside IntelliJ yet, but this should start things rolling.
+ 
+ That's about it for Lucene itself, but for the contrib modules it's almost as straight-forward.
Go through the same "create module from scratch" and optionally move the new module to a group
or sub-group. You can create a new module from the source at, say, ~/apache/trunk/lucene/contrib/queryparser.
Resolve as above by making this module dependent upon other modules (in this case, Lucene
and Lucene_test), and the "project library" at ~/apache/trunk/lucene/lib (note, you should
have created this when you initially set up the original Lucene and Lucene_test modules).
+ 
+ NOTE: some contrib modules depend upon other contrib modules, so you may have to create
several contrib modules to resolve all of these. Highlighter is a case in point.
+ 
+ Test should now run for the contrib module. One quirk I'm seeing is that bringing up the
context menu for a contrib test directory wants to run the Lucene_Test tests. But going one
level down and bringing up the context menu for, say, org.apache.lucene.queryParser runs the
tests in that module.
+ 
+ As usual, the first time one does all this it's mysterious and often requires several false
starts, but pretty soon it takes "just a few clicks of the mouse".
  
  === Installing code style ===
  To install the Lucene/SOLR codestyle files, get the IntelliJ codestyle file from this site
and put it in the magic place so IntelliJ can find it. On my Mac that is in ~/Library/Preferences/IntelliJ90/codestyles
and restart IntelliJ.

Mime
View raw message