Package: west
This is the Zephyr RTOS meta tool,west.https://docs.zephyrproject.org/latest/guides/west/index.htmlInstallationUsing pip:pip3 install west(Usepip3 uninstall westto uninstall it.)Basic UsageWest lets you manage multiple Git repositories under a single directory using a
single file, called thewest manifest file, ormanifestfor short.
By default the manifest file is namedwest.yml.
You usewest initto set up this directory, thenwest updateto fetch
and/or update the repositories named in the manifest.By default, west usesupstream Zephyr’s manifest file, but west
doesn’t care if the manifest repository is zephyr or not. You can and are
encouraged to make your own manifest repositories to meet your needs.For more details, see theWest guidein the Zephyr
documentation.Example usage using the upstream manifest file:mkdir zephyrproject && cd zephyrproject
west init
west updateWhat just happened:west initclones the upstreamwest manifestrepository, which in this
case is the zephyr repository. The manifest repository containswest.yml,
a YAML description of the Zephyr installation, including Git repositories and
other metadata.west updateclones the other repositories named in the manifest file,
creating working trees in the installation directoryzephyrproject.Usewest init-mto specify another manifest repository. Use--mrto
use a revision to inialize from; if not given, the remote’s default branch is used.
Use--mfto use a manifest file other thanwest.yml.Additional CommandsWest has multiple sub-commands. After runningwest init, you can
run them from anywhere underzephyrproject.For a list of available commands, runwest-h. Get help on a
command withwest <command>-h.West is extensible: you can add new commands to west without modifying its
source code. SeeExtensionsin the
documentation for details.Running the TestsFirst, install tox:# macOS, Windows
pip3 install tox

# Linux
pip3 install --user toxThen, run the test suite locally from the top level directory:toxYou can use--to tell tox to pass arguments topytest. This is
especially useful to focus on specific tests and save time. Examples:# Run a subset of tests
tox  --  tests/test_project.py

# Debug the ``test_update_narrow()`` code with ``pdb`` (but _not_ the
# west code which is running in subprocesses)
tox  --  --verbose --exitfirst --trace -k test_update_narrow

# Run all tests with "import" in their name and let them log to the
# current terminal
tox  --  -v -k import --capture=noThe tests cannot be run withpytestdirectly, they require the tox
environment.See the tox configuration file, tox.ini, for more details.Hacking on WestThis section contains notes for getting started developing west itself.Editable InstallTo run west “live” from the current source code tree, run this command from the
top level directory in the west repository:pip3 install -e .This is useful if you are actively working on west and don’t want to re-package
and install a wheel each time you run it.Installing from SourceYou can create and install a wheel package to install west as well.
ThewheelPython package is required to do this. See “Installing Wheel”
below if you need to do this.To build the west wheel file:# macOS, Linux
python3 setup.py bdist_wheel

# Windows
py -3 setup.py bdist_wheelThis will create a file nameddist/west-x.y.z-py3-none-any.whl,
wherex.y.zis the current version in setup.py.To install the wheel:pip3 install -U dist/west-x.y.z-py3-none-any.whlYou canpip3 uninstall westto remove this wheel before re-installing the
version from PyPI, etc.Installing WheelOn macOS and Windows, you can install wheel with:pip3 install wheelThat also works on Linux, but you may want to install wheel from your
system package manager instead – e.g. if you installed pip from your
system package manager. The wheel package is likely named something
likepython3-wheelin that case.