Console: Add "--top-level" flag to show command.

[KGB33]

Pull Request Check List

Resolves: #4175
Resolves: #1990
Relates to: #4342, #2684

• Added tests for changed code.
• Updated documentation for changed code.

---

The above issues all request a way, for various reasons, to view only explicitly defined dependencies using the poetry show command. This PR adds the --top-level/-T flag to display these dependencies.

Examples

❯ poetry run poetry show --top-level --only=test
cachy           0.3.0  Cachy provides a simple yet effective caching library.
deepdiff        6.2.2  Deep Difference and Search of any Python object/data. Recreate objects by adding adding deltas to each other.
httpretty       1.1.4  HTTP client mock for Python
pytest          7.2.0  pytest: simple powerful testing with Python
pytest-cov      4.0.0  Pytest plugin for measuring coverage.
pytest-mock     3.10.0 Thin-wrapper around the mock package for easier use with pytest
pytest-randomly 3.12.0 Pytest plugin to randomly order tests and control random.seed.

Show out-of-date top level dependencies:

❯ poetry run poetry show --top-level --outdated --only=main
filelock           3.8.2     3.9.0     A platform independent file lock.
importlib-metadata 5.1.0     6.0.0     Read metadata from Python packages
keyring            23.11.0   23.13.1   Store and access your passwords safely.
packaging          22.0      23.0      Core utilities for Python packages
pkginfo            1.9.4     1.9.6     Query metadatdata from sdists / bdists / installed packages.
platformdirs       2.6.0     2.6.2     A small Python package for determining appropriate platform-specific dirs, e.g. a "user data dir".
requests           2.28.1    2.28.2    Python HTTP for Humans.
trove-classifiers  2022.12.1 2023.1.20 Canonical source for classifiers on PyPI (pypi.org).
urllib3            1.26.13   1.26.14   HTTP library with thread-safe connection pooling, file post, and more.

It also errors when used with --tree and [package]

❯ poetry run poetry show --top-level --tree                
Error: Cannot use --tree and --top-level at the same time. 

❯ poetry run poetry show --top-level pytest
Error: Cannot use --top-level when displaying a single package.

[Secrus]

Please resolve the conflict.

[KGB33]

Please resolve the conflict.

Done!
Let me know if there is anything else you need.

[radoering]

Can you add tests for the new errors, please? See

poetry/tests/console/commands/test_show.py

Lines 2023 to 2030 in d699b24

	def test_show_errors_without_lock_file(tester: CommandTester, poetry: Poetry) -> None:
	assert not poetry.locker.lock.exists()
	tester.execute()
	expected = "Error: poetry.lock not found. Run `poetry lock` to create it.\n"
	assert tester.io.fetch_error() == expected
	assert tester.status_code == 1

for example.

[Kobold]

@KGB33 cheering you on from the cheap seats over here! I’m excited for your PR.

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.