Eclipse Import Projects Plug-in

This plug-in allows import of projects using an Eclipse command-line parameter. It is useful in situations where Maven is producing the .project files and Eclipse would ideally import/refresh them when launched.

Installation

Place the com.seeq.eclipse.importprojects JAR file in the eclipse/plugins folder.

Usage

When launching Eclipse, add the -import <root project folder> command line parameter. This will cause Eclipse to recursively search the supplied folder for .project files and import them into the workspace. If they are already present in the workspace, they will be refreshed. The path supplied must be an absolute path.

You can supply multiple -import directives to import multiple folders. E.g. -import <folder 1> -import <folder 2>.

The plugin will log activity and any errors to the Eclipse Error Log view (Window > Show View > Other > Error Log).

Supported Configurations

This plugin has been tested with Eclipse Helios (4.2), Kepler (4.3), Luna (4.4) and Mars (4.5) against Java 7 and 8. It will probably work with other configurations but they haven't been tested.

Building

This plugin builds using Maven. It has been tested with Maven 3.2.3.

With Maven on your path, execute mvn package from the root of the repository. The target folder will contain the resulting jar file.

Debugging

You can debug this plugin from Eclipse using the Plugin Development Environment. Take the following steps:

1. Create the Eclipse project files from Maven by executing mvn eclipse:eclipse at the root of the repo.
2. Install the "Eclipse for RCP and RAP Developers" edition of Eclipse and launch it.
3. Import the plugin project via File > Import... > General > Existing Projects into Workspace.
4. Go to Preferences > Java > Build Path > Classpath Variables and add an M2_REPO variable if it doesn't already exist. It should point to your local Maven repository, which by default is ~/.m2/repository.
5. Open up ImportProjects.java and put a breakpoint in earlyStartup().
6. Select Run > Debug Configurations... and click Eclipse Application.
7. Press the New button to create a new debug configuration. Call it whatever you like.
8. Click on the Arguments tab and add an -import <dir> directive to the Program arguments section.
9. Click on Apply and then Debug and you should hit your breakpoint.

License

MIT License

Copyright (C) 2014 Seeq Corporation

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.