Skip to content

Commit

Permalink
west v1.0.0
Browse files Browse the repository at this point in the history
Major changes in this release:

- The APIs are now declared stable. Any breaking changes will be
  communicated by a major version bump from v1.x.y to v2.x.y.

- West v1.0 no longer works with the Zephyr v1.14 LTS releases. This LTS has
  long been obsoleted by Zephyr v2.7 LTS. If you need to use Zephyr v1.14, you
  must use west v0.14 or earlier.

- Like the rest of Zephyr, west now requires Python v3.8 or later

- West commands no longer accept abbreviated command line arguments. For
  example, you must now specify "west update --keep-descendants" instead of
  using an abbreviation like "west update --keep-d". This is part of a change
  applied to all of Zephyr's Python scripts' command-line interfaces. The
  abbreviations were causing problems in practice when commands were updated to
  add new options with similar names but different behavior to existing ones.

Other changes:

- All built-in west functions have stopped using "west.log"

- "west update": new "--submodule-init-config" option.
  See commit 9ba92b0 for details.

Bug fixes:

- West extension commands that failed to load properly sometimes dumped stack.
  This has been fixed and west now prints a sensible error message in this case.

- "west config" now fails on malformed configuration option arguments
  which lack a "." in the option name

API changes:

- The west package now contains the metadata files necessary for some static
  analyzers (such as mypy) to auto-detect its type annotations.
  See commit d9f00e2 for details.

- the deprecated "west.build" module used for Zephyr v1.14 LTS compatibility was
  removed

- the deprecated "west.cmake" module used for Zephyr v1.14 LTS compatibility was
  removed

- the "west.log" module is now deprecated. This module's uses global state,
  which can make it awkward to use it as an API which multiple different python
  modules may rely on.

- The west.commands module got some new APIs which lay groundwork
  for a future change to add a global verbosity control to a command's output,
  and work to remove global state from the "west" package's API:

  - New "west.commands.WestCommand.__init__()" keyword argument: "verbosity"
  - New "west.commands.WestCommand" property: "color_ui"
  - New "west.commands.WestCommand" methods, which should be used to print output
    from extension commands instead of writing directly to sys.stdout or
    sys.stderr: "inf()", "wrn()", "err()", "die()", "banner()",
    "small_banner()"
  - New "west.commands.VERBOSITY" enum

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
  • Loading branch information
mbolivar-nordic committed Feb 20, 2023
1 parent 3534979 commit ef71fae
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion src/west/version.py
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
# This is the Python 3 version of option 3 in:
# https://packaging.python.org/guides/single-sourcing-package-version/#single-sourcing-the-version

__version__ = '1.0.0a1'
__version__ = '1.0.0'
#
# MAINTAINERS:
#
Expand Down

0 comments on commit ef71fae

Please sign in to comment.