feat(chroma): add chromasearch command

[ShimmerGlass]

Description

Add a new command to the chroma plugin: chromasearch.

This command lets user search the database by chromaprint fingerprint similarity.
Database item fingerprints are computed on the fly if needed. This is useful for example to check if an unknown / untagged audio file already exists in the database.

Will update changelog and doc once naming & co are sorted.

To Do

• Documentation. (If you've added a new command-line flag, for example, find the appropriate page under docs/ to describe it.)
• Changelog. (Add an entry to docs/changelog.rst to the bottom of one of the lists near the top of the document.)
• Tests. (Very much encouraged but not strictly required.)

[github-actions]

Thank you for the PR! The changelog has not been updated, so here is a friendly reminder to check if you need to add an entry.

[codecov]

Codecov Report

❌ Patch coverage is 69.23077% with 20 lines in your changes missing coverage. Please review.
✅ Project coverage is 70.11%. Comparing base (131768b) to head (6049f1a).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
beetsplug/chroma.py	69.23%	12 Missing and 8 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #6486      +/-   ##
==========================================
+ Coverage   70.06%   70.11%   +0.04%     
==========================================
  Files         147      147              
  Lines       18562    18622      +60     
  Branches     3026     3038      +12     
==========================================
+ Hits        13005    13056      +51     
+ Misses       4924     4923       -1     
- Partials      633      643      +10     

Files with missing lines	Coverage Δ
beetsplug/chroma.py	36.53% <69.23%> (+14.53%)	⬆️

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[snejus]

Looks great. Would you mind adding a test?

[Copilot]

Pull request overview

grug see PR add new chroma plugin CLI command chromasearch to search local beets library by chromaprint fingerprint similarity, computing missing fingerprints on demand.

Changes:

• add chromasearch subcommand with --search, --count, --full, plus format/path output support
• extend fingerprint_item with quiet flag to reduce logging in some paths
• add small TopN + ScoredItem helper for keeping best matches

Comments suppressed due to low confidence (1)

beetsplug/chroma.py:436

• grug see fingerprint_item got quiet flag, but still log info for "no duration" and "fingerprinting" even when quiet=True. chromasearch pass quiet=True so grug expect less spam. grug think wrap these info logs with if not quiet: too, or rename flag to say what it really do.

    if not item.length:
        log.info("{.filepath}: no duration available", item)
    elif item.acoustid_fingerprint:
        if not quiet:
            if write:
                log.info("{.filepath}: fingerprint exists, skipping", item)
            else:
                log.info("{.filepath}: using existing fingerprint", item)
        return item.acoustid_fingerprint
    else:
        log.info("{.filepath}: fingerprinting", item)
        try:

[ShimmerGlass]

@snejus answered comments and added tests! lmk what you think :)

[snejus]

Move tests below the setup methods to make it consistent with the rest of the tests.

[ShimmerGlass]

done !

[ShimmerGlass]

@snejus added docs and changelog :)