Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/go-ego/riot

Go Open Source, Distributed, Simple and efficient Search Engine; Warning: This is V1 and beta version, because of big memory consume, and the V2 will be rewrite all code.
https://github.com/go-ego/riot

go golang gwk index riot search search-engine

Last synced: 3 months ago
JSON representation

Go Open Source, Distributed, Simple and efficient Search Engine; Warning: This is V1 and beta version, because of big memory consume, and the V2 will be rewrite all code.

Awesome Lists containing this project

README 

        
# Riot search






[![CircleCI Status](https://circleci.com/gh/go-ego/riot.svg?style=shield)](https://circleci.com/gh/go-ego/riot)

![Appveyor](https://ci.appveyor.com/api/projects/status/github/go-ego/riot?branch=master&svg=true)

[![codecov](https://codecov.io/gh/go-ego/riot/branch/master/graph/badge.svg)](https://codecov.io/gh/go-ego/riot)

[![Build Status](https://travis-ci.org/go-ego/riot.svg)](https://travis-ci.org/go-ego/riot)

[![Go Report Card](https://goreportcard.com/badge/github.com/go-ego/riot)](https://goreportcard.com/report/github.com/go-ego/riot)

[![GoDoc](https://godoc.org/github.com/go-ego/riot?status.svg)](https://godoc.org/github.com/go-ego/riot)

[![GitHub release](https://img.shields.io/github/release/go-ego/riot.svg)](https://github.com/go-ego/riot/releases/latest)

[![Join the chat at https://gitter.im/go-ego/ego](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/go-ego/ego?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)



Go Open Source, Distributed, Simple and efficient full text search engine.



[简体中文](https://github.com/go-ego/riot/blob/master/README_zh.md)



# Features



* [Efficient indexing and search](/docs/en/benchmarking.md) (1M blog 500M data 28 seconds index finished, 1.65 ms search response time, 19K search QPS）

* Support for [logical search](https://github.com/go-ego/riot/blob/master/docs/en/logic.md)

* Support Chinese word segmentation (use [gse word segmentation package](https://github.com/go-ego/gse) concurrent word, speed 27MB / s）

* Support the calculation of the keyword in the text [close to the distance](/docs/en/token_proximity.md)（token proximity）

* Support calculation [BM25 correlation](/docs/en/bm25.md)

* Support [custom scoring field and scoring rules](/docs/en/custom_scoring_criteria.md)

* Support [add online, delete index](/docs/en/realtime_indexing.md)

* Support heartbeat

* Support multiple [persistent storage](/docs/en/persistent_storage.md)

* Support [distributed index and search](https://github.com/go-ego/riot/tree/master/data)

* Can be achieved [distributed index and search](/docs/en/distributed_indexing_and_search.md)



* [Look at Word segmentation rules](https://github.com/go-ego/riot/blob/master/docs/en/segmenter.md)



## Requirements

Go version >= 1.8



### Dependencies



Riot uses go module or dep to manage dependencies. 



## Installation/Update



```

go get -u github.com/go-ego/riot

```



## [Build-tools](https://github.com/go-ego/re)

```

go get -u github.com/go-ego/re 

```

### re riot

To create a new riot application



```

$ re riot my-riotapp

```



### re run



To run the application we just created, you can navigate to the application folder and execute:

```

$ cd my-riotapp && re run

```



## Usage:



#### [Look at an example](/examples/simple/main.go)



```go

package main



import (

	"log"



	"github.com/go-ego/riot"

	"github.com/go-ego/riot/types"

)



var (

	// searcher is coroutine safe

	searcher = riot.Engine{}

)



func main() {

	// Init

	searcher.Init(types.EngineOpts{

		// Using:             4,

		NotUseGse: true,

		})

	defer searcher.Close()



	text := "Google Is Experimenting With Virtual Reality Advertising"

	text1 := `Google accidentally pushed Bluetooth update for Home

	speaker early`

	text2 := `Google is testing another Search results layout with 

	rounded cards, new colors, and the 4 mysterious colored dots again`

	

	// Add the document to the index, docId starts at 1

	searcher.Index("1", types.DocData{Content: text})

	searcher.Index("2", types.DocData{Content: text1}, false)

	searcher.IndexDoc("3", types.DocData{Content: text2}, true)



	// Wait for the index to refresh

	searcher.Flush()

	// engine.FlushIndex()



	// The search output format is found in the types.SearchResp structure

	log.Print(searcher.Search(types.SearchReq{Text:"google testing"}))

}

```



It is very simple!



### Use default engine:



```Go

package main



import (

	"log"



	"github.com/go-ego/riot"

	"github.com/go-ego/riot/types"

)



var (

	searcher = riot.New("zh")

)



func main() {

	data := types.DocData{Content: `I wonder how, I wonder why

		, I wonder where they are`}

	data1 := types.DocData{Content: "所以, 你好, 再见"}

	data2 := types.DocData{Content: "没有理由"}



	searcher.Index("1", data)

	searcher.Index("2", data1)

	searcher.Index("3", data2)

	searcher.Flush()



	req := types.SearchReq{Text: "你好"}

	search := searcher.Search(req)

	log.Println("search...", search)

}

```



#### [Look at more Examples](https://github.com/go-ego/riot/tree/master/examples)



#### [Look at Store example](https://github.com/go-ego/riot/blob/master/examples/store/main.go)

#### [Look at Logic search example](https://github.com/go-ego/riot/blob/master/examples/logic/main.go)



#### [Look at Pinyin search example](https://github.com/go-ego/riot/blob/master/examples/pinyin/main.go)



#### [Look at different dict and language search example](https://github.com/go-ego/riot/blob/master/examples/dict/main.go)



#### [Look at benchmark example](https://github.com/go-ego/riot/blob/master/examples/benchmark/benchmark.go)



#### [Riot search engine templates, client and dictionaries](https://github.com/go-ego/riot/tree/master/data)



## Authors



* [Maintainers](https://github.com/orgs/go-ego/people)

* [Contributors](https://github.com/go-ego/riot/graphs/contributors)



## License



Riot is primarily distributed under the terms of the Apache License (Version 2.0), base on [wukong](https://github.com/huichen/wukong).