Skip to content

Lucas brings Apache Lucene's Luke standalone desktop application to IntelliJ-based IDEs

License

Notifications You must be signed in to change notification settings

picimako/lucas

Repository files navigation

Lucas (Apache Lucene's Luke for IntelliJ)

Version

Lucas is a plugin that brings Apache Lucene's Luke standalone desktop application to IntelliJ-based IDEs. Its goal is to provide a way to use Luke in an integrated way.

IMPORTANT: The plugin is in beta state, and will stay in that for a while, so please use it with care, always have a backup of your indexes, and report issues if you find any.

It aims to also use and mirror the source code and functionality of Luke itself as much as possible, so that it remains close to the original application, minimizing maintenance efforts, while still providing extra, IDE specific functionality.

The tool can be opened with the menu action at Tools / Luke - Lucene Toolbox, or via the Search everywhere feature with the same name, and it opens on a new editor tab. Only one Luke editor tab can be open at once, calling the action again focuses on the already open Luke editor.

Main differences between Lucas and Luke:

  • Opening the Luke tab in the IDE doesn't open up the Open Index dialog automatically. A plugin setting might be added in a future release to toggle this.
  • Luke's themes are removed. The plugin uses the theme currently set in the IDE.
  • Some buttons, icons, and UI element sizes are different, and may be located slightly elsewhere, to provide a smoother integration and user experience.
  • The Help menu and About dialog have been removed.

Lucas UI Overview tab

Reporting issues

Changes (maybe with some exceptions) will be introduced only when they have already been introduced in Luke itself (be it feature or bugfix), or when they are specific to the IDE/plugin and don't require a corresponding change in Luke.

Thus, before reporting an issue, please check if it can be reproduced in Luke itself (depending on the nature of the issue). If it can be, please raise the issue under the Apache/Lucene repository, otherwise report it in this one.

Project structure notes

Files that were copied from Lucene/Luke and modified for this integration, are located inside their corresponding com.picimako.[original package in Luke] packages for easier discovery and mapping.

The integration process of Luke into IntelliJ

If you are interested in what steps I took to integrate Luke into IntelliJ, or you need a kind of guide to integrate it into a different IDE, you can find the detailed, sort of step-by-step guide in the Luke integration steps document.


Plugin based on the IntelliJ Platform Plugin Template.