2019-03-27 12:15:23 +01:00
# ![bleve](docs/bleve.png) bleve
2020-09-07 00:51:14 +02:00
[![Tests ](https://github.com/blevesearch/bleve/workflows/Tests/badge.svg?branch=master&event=push )](https://github.com/blevesearch/bleve/actions?query=workflow%3ATests+event%3Apush+branch%3Amaster)
[![Coverage Status ](https://coveralls.io/repos/github/blevesearch/bleve/badge.svg?branch=master )](https://coveralls.io/github/blevesearch/bleve?branch=master)
[![GoDoc ](https://godoc.org/github.com/blevesearch/bleve?status.svg )](https://godoc.org/github.com/blevesearch/bleve)
2019-03-27 12:15:23 +01:00
[![Join the chat at https://gitter.im/blevesearch/bleve ](https://badges.gitter.im/Join%20Chat.svg )](https://gitter.im/blevesearch/bleve?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
[![codebeat ](https://codebeat.co/badges/38a7cbc9-9cf5-41c0-a315-0746178230f4 )](https://codebeat.co/projects/github-com-blevesearch-bleve)
[![Go Report Card ](https://goreportcard.com/badge/blevesearch/bleve )](https://goreportcard.com/report/blevesearch/bleve)
2020-09-07 00:51:14 +02:00
[![Sourcegraph ](https://sourcegraph.com/github.com/blevesearch/bleve/-/badge.svg )](https://sourcegraph.com/github.com/blevesearch/bleve?badge)
[![License ](https://img.shields.io/badge/License-Apache%202.0-blue.svg )](https://opensource.org/licenses/Apache-2.0)
2019-03-27 12:15:23 +01:00
modern text indexing in go - [blevesearch.com ](http://www.blevesearch.com/ )
## Features
* Index any go data structure (including JSON)
* Intelligent defaults backed up by powerful configuration
* Supported field types:
* Text, Numeric, Date
* Supported query types:
* Term, Phrase, Match, Match Phrase, Prefix
* Conjunction, Disjunction, Boolean
* Numeric Range, Date Range
* Simple query [syntax ](http://www.blevesearch.com/docs/Query-String-Query/ ) for human entry
* tf-idf Scoring
* Search result match highlighting
* Supports Aggregating Facets:
* Terms Facet
* Numeric Range Facet
* Date Range Facet
## Discussion
Discuss usage and development of bleve in the [google group ](https://groups.google.com/forum/#!forum/bleve ).
## Indexing
```go
message := struct{
Id string
From string
Body string
}{
Id: "example",
From: "marty.schoch@gmail.com",
Body: "bleve indexing is easy",
}
mapping := bleve.NewIndexMapping()
index, err := bleve.New("example.bleve", mapping)
if err != nil {
panic(err)
}
index.Index(message.Id, message)
```
## Querying
```go
index, _ := bleve.Open("example.bleve")
query := bleve.NewQueryStringQuery("bleve")
searchRequest := bleve.NewSearchRequest(query)
searchResult, _ := index.Search(searchRequest)
```
## License
Apache License Version 2.0