docs(tools): mention how to use extras (#8972)

## Summary Figured this could be helpful to mention in the documentation, as it might not be obvious that this is possible. ## Test Plan Tested the commands locally.
2024-11-11 15:58:31 +01:00
parent 9368268e49
commit 85a7d458f9
1 changed files with 14 additions and 0 deletions
@@ -93,6 +93,20 @@ $ uvx --from 'ruff>0.2.0,<0.3.0' ruff check

 Note the `@` syntax cannot be used for anything other than an exact version.

+## Requesting extras
+
+The `--from` option can be used to run a tool with extras:
+
+```console
+$ uvx --from 'mypy[faster-cache,reports]' mypy --xml-report mypy_report
+```
+
+This can also be combined with version selection:
+
+```console
+$ uvx --from 'mypy[faster-cache,reports]==1.13.0' mypy --xml-report mypy_report
+```
+
 ## Requesting different sources

 The `--from` option can also be used to install from alternative sources.