project: Switch to pyproject

Starting with PEP 621, `pyproject.toml` is the standard way of
specifying project metadata.

Also switch to using the version from `pyproject.toml` instead of having
a west.version python module. Adjust documentation for the same.

Signed-off-by: Ayush Singh <ayushdevel1325@gmail.com>

MAINTAINERS.rst

@@ -66,8 +66,8 @@ Pre-release test plan
 
 7. Assuming that all went well (if it didn't, go fix it and repeat):
 
-   - update __version__ to 'X.Y.Z' (i.e. drop the 'aN' suffix that denotes
-     alpha N)
+   - update version in pyproject.toml to 'X.Y.Z' (i.e. drop the 'aN' suffix
+     that denotes alpha N)
 
    - tag the release on GitHub (see "Tagging the release" for a procedure)
 
@@ -158,7 +158,7 @@ Summary of what happens:
 3. In vX.Y-branch, in src/west/version.py, set __version__ to X.Y.0a1.
    Push this to origin/vX.Y-branch. You don't need a PR for this.
 
-4. In the main branch, set __version__ to X.Y.99.
+4. In the main branch, set version in pyproject.toml to X.Y.99.
    Push this to origin/main. You don't need a PR for this.
 
 5. Create an annotated tag vX.Y.99 which points to the main branch commit you

pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=61.2"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "west"
+version = "1.2.99"
+authors = [{name = "Zephyr Project", email = "devel@lists.zephyrproject.org"}]
+description = "Zephyr RTOS Project meta-tool"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: Microsoft :: Windows",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "colorama",
+    "PyYAML>=5.1",
+    "pykwalify",
+    "setuptools",
+    "packaging",
+]
+
+[project.license]
+file = "LICENSE"
+
+[project.readme]
+file = "README.rst"
+content-type = "text/x-rst"
+
+[project.urls]
+Homepage = "https://github.com/zephyrproject-rtos/west"
+
+[project.scripts]
+west = "west.app.main:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+zip-safe = false
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+namespaces = false

src/west/app/main.py

@@ -40,7 +40,9 @@
     ManifestVersionError, ManifestImportFailed, _ManifestImportDepth, \
     ManifestProject, MANIFEST_REV_BRANCH
 from west.util import quote_sh_list, west_topdir, WestNotFound
-from west.version import __version__
+import importlib.metadata
+
+__version__ = importlib.metadata.version("west")
 
 class EarlyArgs(NamedTuple):
     # Data type for storing "early" argument parsing results.

tests/test_main.py

@@ -1,8 +1,9 @@
+import importlib.metadata
 import os
 import subprocess
 import sys
 
-import west.version
+__version__ = importlib.metadata.version("west")
 
 assert 'TOXTEMPDIR' in os.environ, "you must run these tests using tox"
 
@@ -16,5 +17,5 @@ def test_main():
     output_as_module = subprocess.check_output([sys.executable, '-m', 'west',
                                                 '--version']).decode()
     output_directly = subprocess.check_output(['west', '--version']).decode()
-    assert west.version.__version__ in output_as_module
+    assert __version__ in output_as_module
     assert output_as_module == output_directly