Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-06 08:39:17 +01:00
Code Issues Projects Releases Wiki Activity

Add a changelog note and a mention in queries.rst

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

10
docs/changelog.rst
View file

@ -6,6 +6,16 @@ Unreleased
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:
* Improved naming of temporary files by separating the random part with the file extension.

19
docs/reference/query.rst
View file

@ -17,7 +17,9 @@ This command::
$ 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::
@ -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
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
-------
@ -115,9 +126,9 @@ the field name's colon and before the expression::
$ beet list artist:=AIR
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
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.
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``.
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.
You can set the default sorting behavior with the :ref:`sort_item` and