fluentnest

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 38 Open GitHub ↗

Fluent query language for ElasticSearch built on top of Nest

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FluentNest

[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/fluentnest/community)

Fluent way to query ElasticSearch from C# based on  [NEST](https://github.com/elastic/elasticsearch-net).

| Elastic Search & Nest Version | Build | Nuget | Branch |
| ----------------------------- |:-----:| :----:|:------:|
| 6.x   | [![Build 6.x][build_6]][appveyor]   | [![Nuget Package][nuget_6_shield]][nuget_6] | [master][github_6]
| 5.x   | [![Build 5.x][build_5]][appveyor]   | [![Nuget Package][nuget_5_shield]][nuget_5] | [5.x][github_5]
| 2.x   | [![Build 2.x][build_2]][appveyor]   | [![Nuget Package][nuget_2_shield]][nuget_2] | [2.x][github_2]
| 1.7.x | [![Build 1.7.x][build_1]][appveyor] | [![Nuget Package][nuget_1_shield]][nuget_1] | [1.x][github_1]

[appveyor]: https://ci.appveyor.com/project/hoonzis/fluentnest/history

[build_6]: https://ci.appveyor.com/api/projects/status/wrorpoekyw416hn1/branch/master?svg=true
[nuget_6]: https://www.nuget.org/packages/fluentnest
[nuget_6_shield]: https://img.shields.io/nuget/v/fluentnest.svg
[github_6]: https://github.com/hoonzis/fluentnest/

[build_5]: https://ci.appveyor.com/api/projects/status/wrorpoekyw416hn1/branch/5.x?svg=true
[nuget_5]: https://www.nuget.org/packages/FluentNest/5.0.227
[nuget_5_shield]: https://img.shields.io/badge/nuget-v5.0.227-blue.svg
[github_5]: https://github.com/hoonzis/fluentnest/tree/5.x

[build_2]: https://ci.appveyor.com/api/projects/status/wrorpoekyw416hn1/branch/2.x?svg=true
[nuget_2]: https://www.nuget.org/packages/FluentNest/2.0.217
[nuget_2_shield]: https://img.shields.io/badge/nuget-v2.0.217-blue.svg
[github_2]: https://github.com/hoonzis/fluentnest/tree/2.x

[build_1]: https://ci.appveyor.com/api/projects/status/wrorpoekyw416hn1/branch/1.0.0?svg=true
[nuget_1]: https://www.nuget.org/packages/FluentNest/1.0.210
[nuget_1_shield]: https://img.shields.io/badge/nuget-v1.0.210-blue.svg
[github_1]: https://github.com/hoonzis/fluentnest/tree/1.0.0

Complex queries in ElasticSearch JSON query language are barely readable. NEST takes some part of the pain away, but nested lambdas are still painful. *FluenNest* tries to simplify the query composition. Details are available in the [wiki](https://github.com/hoonzis/fluentnest/wiki/FluentNest-wiki). Motivation and few implementation details are described in [this blog post.](http://www.hoonzis.com/fluent-interface-for-elastic-search/)

## Statistics

```csharp
var result = client.Search<Car>(sc => sc.Aggregations(agg => agg
    .SumBy(x => x.Price)
    .CardinalityBy(x => x.EngineType)
);

var container = result.Aggregations.AsContainer<Car>();
var priceSum = container.GetSum(x => x.Price);
var engines = container.GetCardinality(x => x.EngineType);
```

## Conditional statistics

Conditional sums can be quite complicated with NEST. One has to define a **Filter** aggregation with nested inner **Sum** or other aggregation. Here is quicker way with FluentNest:

```CSharp
var result = client.Search<Car>(sc => sc.Aggregations(aggs => aggs
    .SumBy(x=>x.Price, c => c.EngineType == EngineType.Diesel)
    .SumBy(x=>x.Sales, c => c.CarType == "Car1"))
);
```

## Filtering and expressions to queries compilation

Filtering on multiple conditions might be complicated since you have to compose filters using **Bool** together with **Must** or **Should** methods, often resulting in huge lambdas. *FluentNest* can compile small expressions into NEST query language:

```csharp
client.Search<Car>(s => s.FilterOn(f => f.Timestamp > startDate && f.Timestamp < endDate));
client.Search<Car>(s => s.FilterOn(f=> f.Ranking.HasValue || f.IsAllowed);
client.Search<Car>(s => s.FilterOn(f=> f.Age > 10 || f.Age < 20 && f.Name == "Peter");
```

## Groups & Histograms

Quite often you might want to calculate an aggregation per group or per histogram bucket:

```csharp
var result = client.Search<Car>(sc => sc.Aggregations(agg => agg
    .SumBy(s => s.Price)
    .GroupBy(s => s.EngineType)
);
```

```csharp
var result = client.Search<Car>(s => s.Aggregations(agg => agg
    .SumBy(x => x.Price, x => x.EngineType == EngineType.Diesel)
    .IntoDateHistogram(date => date.Timestamp, DateInterval.Month)
);
```

Groups and histograms can be also nested:

```csharp
var result = client.Search<Car>(sc => sc.Aggregations(agg => agg
    .SumBy(s => s.Price)
    .GroupBy(s => s.CarType)
    .IntoDateHistogram(date => date.Timestamp, DateInterval.Month));
```

fluentnest

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README