Skip to content
/ Examine Public
forked from Shazwazza/Examine

A .NET indexing and search engine powered by Lucene.Net

Notifications You must be signed in to change notification settings

nzdev/Examine

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nuget Examine Build Build Status

Examine


❤️ If you use and like Examine please consider becoming a GitHub Sponsor ❤️

What is Examine?

Examine allows you to index and search data easily and wraps the Lucene.Net indexing/searching engine. Lucene is super fast and allows for very fast searching even on very large amounts of data. Examine is very extensible and allows you to configure as many indexes as you like and each may be configured individually. Out of the box Examine gives you a Lucene based index implementation as well as a Fluent API that can be used to search for your data.

Installation

via Nuget

PM> Install-Package Examine

Quick start

Tip: IExamineManager is the gateway to working with examine. It's a singleton service that is registered in DI.

  1. Configure Services and create an index

    // Adds Examine Core services
    services.AddExamine();
    
    // Create a Lucene based index
    services.AddExamineLuceneIndex("MyIndex");
  2. Populate the index

    if (examineManager.TryGetIndex("MyIndex", out var myIndex))
    {
        // Add a "ValueSet" (document) to the index 
        // which can contain any data you want.
        myIndex.IndexItem(new ValueSet(
            Guid.NewGuid().ToString(),  //Give the doc an ID of your choice
            "MyCategory",               //Each doc has a "Category"
            new Dictionary<string, object>()
            {
                {"Name", "Frank" },
                {"Address", "Beverly Hills, 90210" }
            }));
    }
  3. Search the index

    var searcher = myIndex.Searcher; // Get a searcher
    var results = searcher.CreateQuery()  // Create a query
        .Field("Address", "Hills")        // Look for any "Hills" addresses
        .Execute();                       // Execute the search

Information and downloads for Examine releases

Documentation

Tip: There are many unit tests in the source code that can be used as Examples of how to do things. There is also a test web project that has plenty of examples of how to configure indexes and search them.

Copyright & Licence

© 2021 by Shannon Deminick

This is free software and is licensed under the Microsoft Public License (Ms-PL)

Flat vector created by freepik - www.freepik.com

About

A .NET indexing and search engine powered by Lucene.Net

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 69.6%
  • HTML 29.3%
  • Other 1.1%