agama-project / agama / 15683799304

74%

push

github

Initial support for sorting storage devices during the search (#2474)

## Problem

The results of the `search` section in the description of `drives`,
`partitions` and `mdRaids` are always sorted by name. Making it very
hard to specify something like "the two biggest disks".

## Solution

This implements support for implementing such searches with the syntax
shown in the following examples:

```json
{
  "search": {
    "sort": { "size": "desc" },
    "max": 2
  }
}
```

Several criteria can be specified to resolve ties.

```json
{
  "search": {
    "sort": [
        { "size": "desc" },
        "name"
    ],
    "max": 2
  }
}
```

And, of course, all that can be combined with a condition to filter out
devices before sorting.

```json
{
  "search": {
    "condition": { "size": { "less": "1TiB" } },
    "sort": { "size": "desc" },
    "max": 2
  }
}
```

## Testing

- Added unit tests for the new parts
- Tested manually

92 of 132 branches covered (69.7%)

Branch coverage included in aggregate %.

62 of 64 new or added lines in 5 files covered. (96.88%)

11318 of 18116 relevant lines covered (62.48%)

42.13 hits per line