//  Copyright (c) 2020 The Bluge Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// 		http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/*
Package bluge is a library for indexing and searching text.

Example Opening New Index, Indexing Data

	config := bluge.DefaultConfig(path)
	writer, err := bluge.OpenWriter(config)
	if err != nil {
		log.Fatalf("error opening writer: %v", err)
	}
	defer writer.Close()

	doc := bluge.NewDocument("example").
		AddField(bluge.NewTextField("name", "bluge"))

	err = writer.Update(doc.ID(), doc)
	if err != nil {
		log.Fatalf("error updating document: %v", err)
	}

Example Getting Index Reader, Searching Data

	    reader, err := writer.Reader()
		if err != nil {
			log.Fatalf("error getting index reader: %v", err)
		}
		defer reader.Close()

		query := bluge.NewMatchQuery("bluge").SetField("name")
		request := bluge.NewTopNSearch(10, query).
			WithStandardAggregations()
		documentMatchIterator, err := reader.Search(context.Background(), request)
		if err != nil {
			log.Fatalf("error executing search: %v", err)
		}
		match, err := documentMatchIterator.Next()
		for err == nil && match != nil {

			// load the identifier for this match
			err = match.VisitStoredFields(func(field string, value []byte) bool {
				if field == "_id" {
					fmt.Printf("match: %s\n", string(value))
				}
				return true
			})
			if err != nil {
				log.Fatalf("error loading stored fields: %v", err)
			}
			match, err = documentMatchIterator.Next()
		}
		if err != nil {
			log.Fatalf("error iterator document matches: %v", err)
		}
*/
package bluge
