play: Add -R/--randomize option to play plugin

[amiv1]

Description

I really wanted to combine random with play to shuffle tracks in a temporary playlist, but couldn't find easy way to do it. I'd like to introduce a new flag -R / --randomize to the play plugin to shuffle tracks before passing them to the player.

I couldn't really decide between -r and -R, not sure if there's any rule there. If you believe lower case would be better, just let me know.

Regarding tests: they're mocking the random.shuffle function and asserting if it's been called or not. Because of the random nature of the feature, it's challenging to create a proper test that will assert the order because there's always a chance that the randomized order will be exactly the same as the input, which may lead to flaky tests.

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.)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 69.52%. Comparing base (c89b94a) to head (dd80ac8).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #6424   +/-   ##
=======================================
  Coverage   69.52%   69.52%           
=======================================
  Files         141      141           
  Lines       18475    18479    +4     
  Branches     3020     3021    +1     
=======================================
+ Hits        12844    12848    +4     
  Misses       4997     4997           
  Partials      634      634           

Files with missing lines	Coverage Δ
beetsplug/play.py	84.54% <100.00%> (+0.58%)	⬆️

🚀 New features to boost your workflow:

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

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.