Update poetry command

[Serene-Arc]

I was getting my development environment set up so I could start contributing code again (yay!) when I noticed that the docs are out of date. poetry shell is no longer part of the core poetry tool, but a plugin. Using poetry env activate is given as a replacement. This just updates the docs to reflect that. I also added a shortcut so people could understand how to install all the extras, since that's pretty necessary for developers.

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

[sourcery-ai]

Hey there - I've reviewed your changes and they look great!

Prompt for AI Agents

Please address the comments from this code review:

## Individual Comments

### Comment 1
<location> `CONTRIBUTING.rst:125` </location>
<code_context>
 ::

-    $ poetry shell
+    $ poetry env activate

 You should see ``(beets-py3.10)`` prefix in your shell prompt. Now you can run
</code_context>

<issue_to_address>
**issue:** Re-check whether `poetry env activate` matches the described behavior of activating the virtual environment and changing the prompt.

This command is described as activating the virtualenv and changing your prompt to show `(beets-py3.10)`. That behavior usually matches `poetry shell`; `poetry env activate` often only prints an activation command instead of starting a new shell. Please verify the behavior with the Poetry version you support and either restore `poetry shell` or adjust the explanation so it matches what actually happens.
</issue_to_address>

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}

[sourcery-ai]

issue: Re-check whether poetry env activate matches the described behavior of activating the virtual environment and changing the prompt.

This command is described as activating the virtualenv and changing your prompt to show (beets-py3.10). That behavior usually matches poetry shell; poetry env activate often only prints an activation command instead of starting a new shell. Please verify the behavior with the Poetry version you support and either restore poetry shell or adjust the explanation so it matches what actually happens.

[JOJ0]

Welcome back again @Serene-Arc 👋 👍

sorcery-ai has a point. we mention that the prompt changes which doesn't with poetry env activate.

there is other commands for showing that info ar adjusting one's prompt manuyll poetry env info for example. We could add that or we just link to the poetry docs which I find better actually. (we might do that already, didn't check)

[JOJ0]

Suggested change

	You should see ``(beets-py3.10)`` prefix in your shell prompt. Now you can run
	Now you can run

[JOJ0]

Suggested change

	$ pytest