@@ -118,6 +118,10 @@ You can create a wheel package and distribute it to others.
118118
119119To build the west wheel file::
120120
121+ # Using uv
122+ uv build
123+
124+ # Without uv
121125 pip3 install --upgrade build
122126 python -m build
123127
@@ -134,33 +138,39 @@ version from PyPI, etc.
134138Running the Tests
135139~~~~~~~~~~~~~~~~~
136140
137- First, install tox ::
141+ First, install the dependencies ::
138142
139- # macOS, Windows
140- pip3 install tox
143+ # Using uv
144+ uv sync --frozen
141145
142- # Linux
143- pip3 install --user tox
146+ # Using pip (requires v25.1 or newer)
147+ # Recommended in an active virtual environment
148+ pip3 install --group dev
144149
145150Then, run the test suite locally from the top level directory::
146151
147- tox
152+ # Using uv
153+ uv run poe all
154+
155+ # Using poe
156+ # Recommended in an active virtual environment
157+ poe all
158+
159+ # Manually
160+ pytest
148161
149- You can use ``-- `` to tell tox to pass arguments to ``pytest ``. This is
150- especially useful to focus on specific tests and save time. Examples::
162+ The ``all `` target from ``poe `` runs multiple tasks sequentially. Run ``poe -h ``
163+ to get the list of configured tasks.
164+ You can pass arguments to the task running ``poe ``. This is especially useful
165+ on specific tests and save time. Examples::
151166
152167 # Run a subset of tests
153- tox -- tests/test_project.py
168+ poe test tests/test_project.py
154169
155- # Debug the ``test_update_narrow()`` code with ``pdb`` (but _not_ the
170+ # Run the ``test_update_narrow()`` code with ``pdb`` (but _not_ the
156171 # west code which is running in subprocesses)
157- tox -- --verbose --exitfirst --trace -k test_update_narrow
172+ poe test --exitfirst --trace -k test_update_narrow
158173
159174 # Run all tests with "import" in their name and let them log to the
160175 # current terminal
161- tox -- -v -k import --capture=no
162-
163- The tests cannot be run with ``pytest `` directly, they require the tox
164- environment.
165-
166- See the tox configuration file, tox.ini, for more details.
176+ poe test -k import --capture=no
0 commit comments