Coder Social home page Coder Social logo

luke's Introduction

luke

Luke, the Lucene Toolbox Project + JavaFX

Luke atop JavaFX.

Luke is the GUI tool for introspecting your Lucene / Solr / Elasticsearch index. It allows:

  • Viewing your documents and analyzing their field contents (for stored fields)
  • Searching in the index
  • Performing index maintenance: index health checking, index optimization (take a backup before running this!)
  • Testing your custom Lucene analyzers

Recent Changes

See CHANGES.txt

Luke discussion group

Luke google group

Search engines luke can deal with

In no particular order:

  • Apache Lucene. Most certainly luke can open lucene index produced by pure Lucene. Do people make pure Lucene indices these days?
  • Apache Solr. Solr and Lucene share the same code base, so it is natural that luke can open Lucene Index produced by Solr.
  • Elasticsearch. Elasticsearch uses Lucene as its lowest-level search engine base. So luke can open its index too!

Intro video about features

This lightning talk was delivered by Dmitry Kan on ApacheCon 2015 in Austin, Texas. ScreenShot

Brief project history

  • The original author is Andrzej Bialecki
  • The project has been mavenized by Neil Ireson (see google group discussion here)
  • The project has been ported to Lucene trunk (marked as 5.0 at the time) by Dmitry Kan
  • The project has been back-ported to Lucene 4.3 by sonarname, who later decided not to continue supporting the project
  • There are updates to the (non-mavenized) project done by tarzanek
  • The UI (and some of core components) has been re-implemented on top of JavaFX by Tomoko Uchida.

This project's goal

  1. Keep the project mavenized (compatible with Apache Lucene and Solr style)
  2. To port the thinlet UI to an ASL compliant license framework so that it can be contributed back to Apache Lucene. Current work is done with JavaFX.
  3. Maintain a single point of trust for the development and updates of the tool. That said, everyone is welcome to join.

Committers

System Requirements

Java 8+ and JavaFX runtime are required.

Launching luke

  1. Clone the repository.
  2. Run mvn install from the project directory. (Make sure you have Java and Maven installed before doing this)
  3. Use luke.sh or luke.bat for launching luke from the command line based on the OS you are in.

(Alternatively, for older versions of luke you can directly download the jar file from the releases page and run it with the command java -jar luke-javafx-with-deps.jar)

Running luke with a custom analyzer or codec

See luke.sh for an example of launching luke with custom components.

Documentation

The documentation is being written along the way of discovering the luke's usage scenarios.

https://github.com/DmitryKey/luke/wiki

You are free and welcome to contribute you findings!

Feature / bug fix requests

Found bug? Missing a useful feature? Raise an issue here:

https://github.com/DmitryKey/luke/issues

Or, and btw, the pull requests are welcome as well!

Releases

All of the releases you find under the "releases" link above are versioned after the Lucene's version they use.

Usually we don't do releases for minor version upgrades, because the major release usually can read the index of the next minor release.

An example: lucene 4.8.0 can read the index generated by lucene 4.8.1. Hence luke 4.8.0 can read too.

Conclusion: in order to find a luke release that can read an index of your version of Lucene, pick the closest major version and download luke for that from the releases page.

Where is (legacy) Thinlet version luke?

luke-thinlet branch holds Thinlet version. From version 7.3.1, the main branch is running JavaFX version luke and Thinlet version is not maintained/updated.

Where is luke 4.4.0 ?

There is no separate luke 4.4.0 release, but luke 4.5.0 should open the Lucene 4.4.0 index just fine.

Licensing

This software is distributed under ALv2, and includes The Elegant Icon Font which is licensed under the MIT. It is in its early days, but give it a spin and let us know what you think! We accept pull-requests :)

luke's People

Contributors

mocobeta avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.