Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stevenferrer/solr-go
A Solr client for Go.
https://github.com/stevenferrer/solr-go
go golang multi-select-facet solr solr-client
Last synced: about 2 months ago
JSON representation
A Solr client for Go.
- Host: GitHub
- URL: https://github.com/stevenferrer/solr-go
- Owner: stevenferrer
- License: mit
- Created: 2020-04-01T11:10:17.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-08T22:27:32.000Z (8 months ago)
- Last Synced: 2024-06-18T18:44:47.718Z (6 months ago)
- Topics: go, golang, multi-select-facet, solr, solr-client
- Language: Go
- Homepage:
- Size: 214 KB
- Stars: 44
- Watchers: 4
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Solr-Go
[](https://coveralls.io/github/stevenferrer/solr-go?branch=main)
[](https://goreportcard.com/report/github.com/stevenferrer/solr-go)
[](https://pkg.go.dev/github.com/stevenferrer/solr-go)
A [Solr](https://solr.apache.org/) client for [Go](https://golang.org/).
## Installation
```console
$ go get github.com/stevenferrer/solr-go
```
## Example
```go
import (
"github.com/stevenferrer/solr-go"
)
...
// Create a client
baseURL := "http://solr.example.com"
client := solr.NewJSONClient(baseURL)
// Create a query
query := solr.NewQuery(solr.NewDisMaxQueryParser().
Query("'solr rocks'").BuildParser()).
Queries(solr.M{
"query_filters": []solr.M{
{
"#size_tag": solr.M{
"field": solr.M{
"f": "size",
"query": "XL",
},
},
},
{
"#color_tag": solr.M{
"field": solr.M{
"f": "color",
"query": "Red",
},
},
},
},
}).
Facets(
solr.NewTermsFacet("categories").
Field("cat").Limit(10),
solr.NewQueryFacet("high_popularity").
Query("popularity:[8 TO 10]"),
).
Sort("score").
Offset(1).
Limit(10).
Filters("inStock:true").
Fields("name", "price")
// Send the query
queryResponse, err := client.Query(context.Background(), "techproducts", query)
```
See [integration test](integration_test.go) for a more complete example.
## Supported APIs
- [Collections API](https://solr.apache.org/guide/8_8/collections-api.html) - Create and delete collection.
- [Core Admin API](https://solr.apache.org/guide/8_8/coreadmin-api.html) - [Create](https://issues.apache.org/jira/browse/SOLR-7316), delete and check core status.
- [Query API](https://solr.apache.org/guide/8_8/json-request-api.html) - Query via the JSON request API.
- [Facet API](https://solr.apache.org/guide/8_8/json-facet-api.html) - Terms and query facet.
- [Update API](https://solr.apache.org/guide/8_8/uploading-data-with-index-handlers.html#uploading-data-with-index-handlers) - JSON formatted index updates.
- [Schema API](https://solr.apache.org/guide/8_8/schema-api.html) - Modify schema fields, dynamic fields, copy fields and field types.
- [Config API](https://solr.apache.org/guide/8_8/config-api.html) - Modify config properties and update components.
- [Suggester API](https://solr.apache.org/guide/8_8/suggester.html) - Auto-suggest/type-ahead via suggester component.
## Other features
- [Basic auth support](https://solr.apache.org/guide/8_8/basic-authentication-plugin.html#basic-authentication-plugin) - Interacting with a Solr server that uses the basic authentication plugin.
## Projects using it
- [Multi-select facet using Solr, Vue and Go](https://github.com/stevenferrer/multi-select-facet)
## A (minor) word of caution
Keep in mind that this library is still evolving and will likely have some breaking changes until v1.0. We will try our best to keep the breaking changes minimal.
## Supporting the project
You can support the project in the following ways:
- Give it a [star](https://github.com/stevenferrer/solr-go/stargazers), it's free!
- Write some tutorials
- Use it your projects
## Contributing
Please feel free to improve this project by [opening an issue](https://github.com/stevenferrer/solr-go/issues/new) or by [making a pull-request](https://github.com/stevenferrer/solr-go/pulls).
## License
MIT