Add a changelog note and a mention in queries.rst

This commit is contained in:
Šarūnas Nejus 2024-06-16 23:44:07 +01:00
parent e61c7d637d
commit 2f80ff07e4
No known key found for this signature in database
GPG key ID: DD28F6704DBE3435
2 changed files with 25 additions and 4 deletions

View file

@ -6,6 +6,16 @@ Unreleased
Changelog goes here! Please add your entry to the bottom of one of the lists below! Changelog goes here! Please add your entry to the bottom of one of the lists below!
New features:
* Ability to query albums with track-level (and vice-versa) **db** or
**flexible** field queries, for example `beet list -a title:something`, `beet
list artpath:cover`.
* Queries have been made faster, and their speed is constant regardless of
their complexity or the type of queried fields. Notably, album queries for
the `path` field and those that involve flexible attributes have seen the
most significant speedup.
Bug fixes: Bug fixes:
* Improved naming of temporary files by separating the random part with the file extension. * Improved naming of temporary files by separating the random part with the file extension.

View file

@ -17,7 +17,9 @@ This command::
$ beet list love $ beet list love
will show all tracks matching the query string ``love``. By default any unadorned word like this matches in a track's title, artist, album name, album artist, genre and comments. See below on how to search other fields. will show all tracks matching the query string ``love``. By default any
unadorned word like this matches in a track's title, artist, album name, album
artist, genre and comments. See below on how to search other fields.
For example, this is what I might see when I run the command above:: For example, this is what I might see when I run the command above::
@ -83,6 +85,15 @@ For multi-valued tags (such as ``artists`` or ``albumartists``), a regular
expression search must be used to search for a single value within the expression search must be used to search for a single value within the
multi-valued tag. multi-valued tag.
Note that you can filter albums by querying their tracks fields, including
flexible attributes::
$ beet list -a title:love
and vice versa::
$ beet list art_path::love
Phrases Phrases
------- -------
@ -115,9 +126,9 @@ the field name's colon and before the expression::
$ beet list artist:=AIR $ beet list artist:=AIR
The first query is a simple substring one that returns tracks by Air, AIR, and The first query is a simple substring one that returns tracks by Air, AIR, and
Air Supply. The second query returns tracks by Air and AIR, since both are a Air Supply. The second query returns tracks by Air and AIR, since both are a
case-insensitive match for the entire expression, but does not return anything case-insensitive match for the entire expression, but does not return anything
by Air Supply. The third query, which requires a case-sensitive exact match, by Air Supply. The third query, which requires a case-sensitive exact match,
returns tracks by AIR only. returns tracks by AIR only.
Exact matches may be performed on phrases as well:: Exact matches may be performed on phrases as well::
@ -358,7 +369,7 @@ result in lower-case values being placed after upper-case values, e.g.,
``Bar Qux foo``. ``Bar Qux foo``.
Note that when sorting by fields that are not present on all items (such as Note that when sorting by fields that are not present on all items (such as
flexible fields, or those defined by plugins) in *ascending* order, the items flexible fields, or those defined by plugins) in *ascending* order, the items
that lack that particular field will be listed at the *beginning* of the list. that lack that particular field will be listed at the *beginning* of the list.
You can set the default sorting behavior with the :ref:`sort_item` and You can set the default sorting behavior with the :ref:`sort_item` and