Lines Matching +full:west +full:- +full:commands
3 .. _west-apis:
4 .. _west-apis-west:
6 West APIs
9 This page documents the Python APIs provided by :ref:`west <west>`, as well as
10 some additional APIs used by the :ref:`west extensions <west-extensions>` in
21 2. if you add a :ref: target here, add it to west-not-found.rst too.
23 .. _west-apis-commands:
25 west.commands
28 .. module:: west.commands
30 All built-in and extension commands are implemented as subclasses of the
37 .. autoclass:: west.commands.WestCommand argument
71 A property which returns the :py:class:`west.manifest.Manifest`
87 :py:class:`west.configuration.Configuration` instance or aborts the
108 True if the west configuration permits colorized output,
141 expediency during the west v1.2 release time frame to work around a build
143 cutting a west point release. (The docstrings in west had some RST syntax
154 The *cwd* keyword argument was replaced with a catch-all ``**kwargs``.
163 The *cwd* keyword argument was replaced with a catch-all ``**kwargs``.
182 ``west.log`` module to a per-command interface that will allow for a global
183 "quiet" mode for west commands in a future release:
214 .. _west-apis-commands-output:
219 Since west v1.0, west commands should print output using methods like
220 west.commands.WestCommand.dbg(), west.commands.WestCommand.inf(), etc. (see argument
223 .. autoclass:: west.commands.Verbosity
238 .. autoclass:: west.commands.CommandError argument
239 :show-inheritance:
245 .. autoclass:: west.commands.CommandContextError
246 :show-inheritance:
248 .. _west-apis-configuration:
250 west.configuration
253 .. automodule:: west.configuration
255 Since west v0.13, the recommended class for reading this is
256 :py:class:`west.configuration.Configuration`.
258 Note that if you are writing a :ref:`west extension <west-extensions>`, you can
260 :py:class:`west.commands.WestCommand`.
265 This is the recommended API to use since west v0.13.
267 .. autoclass:: west.configuration.ConfigFile
269 .. autoclass:: west.configuration.Configuration
277 The following APIs also use :py:class:`west.configuration.ConfigFile`, but they
279 configuration. This has proven to be a bad design decision since west's APIs
280 can be used from multiple workspaces. They were deprecated in west v0.13.0.
283 not be used in new code when west v0.13.0 or later may be assumed.
285 .. autofunction:: west.configuration.read_config
293 .. autofunction:: west.configuration.update_config
295 .. py:data:: west.configuration.config
297 Module-global ConfigParser instance for the current configuration. This
298 should be initialized with :py:func:`west.configuration.read_config` before
301 .. _west-apis-log:
303 west.log (deprecated)
306 .. automodule:: west.log
338 .. _west-apis-manifest:
340 west.manifest
343 .. automodule:: west.manifest
346 represent the contents of a :ref:`manifest file <west-manifests>`. The
347 recommended method for parsing west manifests is
359 .. autofunction:: west.manifest.manifest_path
361 .. autofunction:: west.manifest.validate
366 Manifest and sub-objects
369 .. autoclass:: west.manifest.Manifest
375 All arguments were made keyword-only. The *source_file* argument was
402 Conveniences for accessing sub-objects by name or other identifier:
421 This respects the ``manifest.project-filter`` configuration
422 option. See :ref:`west-config-index`.
424 .. autoclass:: west.manifest.ImportFlag
426 :member-order: bysource
428 .. autoclass:: west.manifest.Project
505 .. autoclass:: west.manifest.ManifestProject
519 .. autoclass:: west.manifest.Submodule
526 .. autoclass:: west.configuration.MalformedConfig
527 :show-inheritance:
529 .. autoclass:: west.manifest.MalformedManifest
530 :show-inheritance:
532 .. autoclass:: west.manifest.ManifestVersionError
533 :show-inheritance:
538 .. autoclass:: west.manifest.ManifestImportFailed
539 :show-inheritance:
547 .. _west-apis-util:
549 west.util
554 .. automodule:: west.util
559 .. autofunction:: west.util.west_dir
564 .. autofunction:: west.util.west_topdir
572 .. autoclass:: west.util.WestNotFound
573 :show-inheritance: