idf-build-apps 2.13.3__tar.gz → 2.14.0__tar.gz

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/.github/workflows/publish-pypi.yml

@@ -9,7 +9,7 @@ jobs:
   deploy:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
           python-version: "3.7"

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/.github/workflows/sync-jira.yml

@@ -46,7 +46,7 @@ jobs:
       pull-requests: write
     steps:
       - name: Check out
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
 
       - name: Run synchronization to Jira
         uses: espressif/sync-jira-actions@v1
@@ -55,7 +55,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           JIRA_PASS: ${{ secrets.JIRA_PASS }}
-          JIRA_PROJECT: RDT
+          JIRA_PROJECT: CII
           JIRA_COMPONENT: idf-build-apps
           JIRA_URL: ${{ secrets.JIRA_URL }}
           JIRA_USER: ${{ secrets.JIRA_USER }}

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/.github/workflows/test-build-docs.yml

@@ -7,7 +7,7 @@ jobs:
   build-docs:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Set up Python
         uses: actions/setup-python@v6
         with:

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/.github/workflows/test-build-idf-apps.yml

@@ -1,5 +1,9 @@
 name: Test Build IDF Apps
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}-${{ github.run_id }}
+  cancel-in-progress: false
+
 on:
   pull_request:
     paths:
@@ -20,7 +24,7 @@ jobs:
   build-python-packages:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - uses: actions/setup-python@v6
         with:
           python-version: '3.7'
@@ -29,7 +33,7 @@ jobs:
           pip install flit
           flit build
       - name: Upload built python packages
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: wheel
           path: dist/idf_build_apps-*.whl
@@ -39,13 +43,13 @@ jobs:
     needs: build-python-packages
     strategy:
       matrix:
-        idf-branch: [ release-v5.0, release-v5.1, release-v5.2, release-v5.3 ]
+        idf-branch: [ release-v5.1, release-v5.2, release-v5.3, release-v5.4, release-v5.5 ]
     runs-on: ubuntu-latest
     container:
       image: espressif/idf:${{ matrix.idf-branch }}
     steps:
       - name: Download wheel
-        uses: actions/download-artifact@v5
+        uses: actions/download-artifact@v7
         with:
           name: wheel
       - name: Build the Apps
@@ -67,7 +71,7 @@ jobs:
     env:
       FLIT_ROOT_INSTALL: 1
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Build the Apps
         run: |
           bash $IDF_PATH/install.sh
@@ -97,7 +101,7 @@ jobs:
         branch:
           - release/v3.4
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Install dependencies
         run: |
           apt update \

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/.pre-commit-config.yaml

@@ -17,13 +17,13 @@ repos:
           - --use-current-year
         exclude: 'idf_build_apps/vendors/'
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 'v0.13.0'
+    rev: 'v0.14.11'
     hooks:
-      - id: ruff
+      - id: ruff-check
         args: ['--fix']
       - id: ruff-format
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: 'v1.18.1'
+    rev: 'v1.19.1'
     hooks:
       - id: mypy
         args: ['--warn-unused-ignores']

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/CHANGELOG.md

@@ -1,9 +1,47 @@
-# Changelog
+<a href="https://www.espressif.com">
+    <img src="https://www.espressif.com/sites/all/themes/espressif/logo-black.svg" align="right" height="20" />
+</a>
+
+# CHANGELOG
+
+> All notable changes to this project are documented in this file.
+> This list is not exhaustive - only important changes, fixes, and new features in the code are reflected here.
+
+<div style="text-align: center;">
+    <a href="https://keepachangelog.com/en/1.1.0/">
+        <img alt="Static Badge" src="https://img.shields.io/badge/Keep%20a%20Changelog-v1.1.0-salmon?logo=keepachangelog&logoColor=black&labelColor=white&link=https%3A%2F%2Fkeepachangelog.com%2Fen%2F1.1.0%2F">
+    </a>
+    <a href="https://www.conventionalcommits.org/en/v1.0.0/">
+        <img alt="Static Badge" src="https://img.shields.io/badge/Conventional%20Commits-v1.0.0-pink?logo=conventionalcommits&logoColor=black&labelColor=white&link=https%3A%2F%2Fwww.conventionalcommits.org%2Fen%2Fv1.0.0%2F">
+    </a>
+    <a href="https://semver.org/spec/v2.0.0.html">
+        <img alt="Static Badge" src="https://img.shields.io/badge/Semantic%20Versioning-v2.0.0-grey?logo=semanticrelease&logoColor=black&labelColor=white&link=https%3A%2F%2Fsemver.org%2Fspec%2Fv2.0.0.html">
+    </a>
+</div>
+<hr>
+
+## v2.14.0 (2026-01-16)
 
-All notable changes to this project will be documented in this file.
+### ✨ New Features
+
+- support root_components placeholder *(igor.udot - 104959e)*
+
+### 🐛 Bug Fixes
+
+- **pre-commit**: change mypy python_version from 3.9 to 3.10 *(Evgeny Torbin - bdf0788)*
+- fixed issue that parser_bool_expr thorws AttributeError not caught *(Xiao Xufeng - 3878948)*
+- `model_validate` does not support `extra` in python<=3.8 *(Fu Hanxi - 8a108a1)*
+- add disabled apps to junit with `--include-all-apps` flag *(Evgeny Torbin - 071d4e3)*
+
+### 📖 Documentation
+
+- base_components placeholder *(igor.udot - 7958201)*
+
+---
 
 ## v2.13.3 (2025-10-23)
 
+---
 
 ## v2.13.2 (2025-10-23)
 
@@ -12,6 +50,7 @@ All notable changes to this project will be documented in this file.
 - update broken tests for `size.json` *(Evgeny Torbin - c603221)*
 - change `idf_size.py --format json` to `--format json2` *(Evgeny Torbin - 49b9f3d)*
 
+---
 
 ## v2.13.1 (2025-09-29)
 
@@ -19,6 +58,7 @@ All notable changes to this project will be documented in this file.
 
 - path checking for modified apps *(Fu Hanxi - 18f554c)*
 
+---
 
 ## v2.13.0 (2025-09-26)
 
@@ -31,6 +71,7 @@ All notable changes to this project will be documented in this file.
 - **find_apps**: ignore target-specific sdkconfig files even without setting CONFIG_IDF_TARGET *(Fu Hanxi - 1861a7a)*
 - record `checked_should_build` *(Fu Hanxi - f37fff1)*
 
+---
 
 ## v2.12.3 (2025-09-16)
 
@@ -591,3 +632,15 @@ This is the last version to support ESP-IDF v4.1 since it's EOL on Feb. 24th, 20
 ### Added
 
 - Use `--format json` instead of `--json` with `idf_size.py`
+
+---
+
+<div style="text-align: center;">
+    <small>
+        <b>
+            <a href="https://www.github.com/espressif/cz-plugin-espressif">Commitizen Espressif plugin</a>
+        </b>
+    <br>
+        <sup><a href="https://www.espressif.com">Espressif Systems CO LTD. (2026)</a><sup>
+    </small>
+</div>

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: idf-build-apps
-Version: 2.13.3
+Version: 2.14.0
 Summary: Tools for building ESP-IDF related apps.
 Author-email: Fu Hanxi <fuhanxi@espressif.com>
 Requires-Python: >=3.7

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/docs/conf_common.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/docs/en/conf.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/docs/en/explanations/dependency_driven_build.rst

@@ -63,6 +63,17 @@ Here is an example of a manifest file:
      depends_filepatterns:
        - "common_header_files/**/*"
 
+You may also reuse a common set of component dependencies by using the special placeholder ``- *common_components`` inside ``depends_components``. This placeholder is expanded when loading the manifest file, using the values provided via the CLI option ``--common-components`` (or the ``common_components`` argument to :meth:`~idf_build_apps.manifest.manifest.Manifest.from_file`).
+
+.. code:: yaml
+
+   # rules.yml
+   examples/foo:
+     depends_components:
+       - *common_components
+       - "some_1"
+       - "some_2"
+
 The apps under folder ``examples/foo`` will be built with the following CLI options:
 
 -  ``--manifest-files rules.yml --modified-files examples/foo/main/foo.c``

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/docs/en/references/manifest.rst

@@ -209,6 +209,15 @@ Reuse Lists
 
 To reuse the items defined in a list, you can use the ``+`` and ``-`` postfixes respectively. The order of calculation is always ``+`` first, followed by ``-``.
 
+Placeholder: ``*common_components``
+-----------------------------------
+
+In addition to YAML anchors, ``idf-build-apps`` also supports a special placeholder entry ``- *common_components`` inside ``depends_components``.
+
+When loading the manifest file, this placeholder is expanded using the values provided via the CLI option ``--common-components`` (or the ``common_components`` argument to :meth:`~idf_build_apps.manifest.manifest.Manifest.from_file`).
+
+This placeholder entry is only supported inside ``depends_components``.
+
 Array Elements as Strings
 -------------------------
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 """
@@ -8,7 +8,7 @@ Tools for building ESP-IDF related apps.
 # ruff: noqa: E402
 # avoid circular imports
 
-__version__ = '2.13.3'
+__version__ = '2.14.0'
 
 from .session_args import (
     SessionArgs,

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/__main__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 from .main import (

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/app.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import copy
@@ -511,7 +511,9 @@ class App(BaseModel):
             BuildStatus.UNKNOWN,
             BuildStatus.SHOULD_BE_BUILT,
         ):
-            self.build_comment = f'Build {self.build_status.value}. Skipping...'
+            if not self.build_comment:
+                self.build_comment = f'Build {self.build_status.value}. Skipping...'
+
             return
 
         # real build starts here

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/args.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import argparse
@@ -302,6 +302,19 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         ),
         default=None,  # type: ignore
     )
+    common_components: t.Optional[t.List[str]] = field(
+        FieldMetadata(
+            validate_method=[ValidateMethod.TO_LIST],
+            type=semicolon_separated_str_to_list,
+            shorthand='-rc',
+        ),
+        description='semicolon-separated list of components. '
+        'expand the `- *common_components` placeholder in manifests. '
+        'Must be specified together with --modified-components. '
+        'If set to "", the value would be considered as None. '
+        'If set to ";", the value would be considered as an empty list.',
+        default=None,  # type: ignore
+    )
     deactivate_dependency_driven_build_by_filepatterns: t.Optional[t.List[str]] = field(
         FieldMetadata(
             validate_method=[ValidateMethod.TO_LIST],
@@ -374,6 +387,7 @@ class DependencyDrivenBuildArguments(GlobalArguments):
             App.MANIFEST = Manifest.from_files(
                 self.manifest_files,
                 root_path=to_absolute_path(self.manifest_rootpath),
+                common_components=self.common_components,
             )
 
     @property

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/autocompletions.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/constants.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import enum

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/finder.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import logging

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/junit/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 from .report import (

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/junit/report.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 """

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/junit/utils.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/log.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import logging

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/main.py

@@ -1,6 +1,6 @@
 # PYTHON_ARGCOMPLETE_OK
 
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import argparse
@@ -386,23 +386,26 @@ def main():
         sys.exit(0)
 
     kwargs = vars(args)
+    kwargs_without_none = drop_none_kwargs(kwargs)
     action = kwargs.pop('action')
     config_file = kwargs.pop('config_file')
     if config_file:
         apply_config_file(config_file)
 
     if action == 'dump-manifest-sha':
-        arguments = DumpManifestShaArguments(**drop_none_kwargs(kwargs))
+        arguments = DumpManifestShaArguments(**kwargs_without_none)
         Manifest.from_files(arguments.manifest_files).dump_sha_values(arguments.output)
         sys.exit(0)
-    elif action == 'find':
-        arguments = FindArguments(**drop_none_kwargs(kwargs))
+
+    if action == 'find':
+        arguments = FindArguments(**kwargs_without_none)
     else:
-        arguments = BuildArguments(**drop_none_kwargs(kwargs))
+        arguments = BuildArguments(**kwargs_without_none)
 
     # real call starts here
     # build also needs to find first
-    apps = find_apps(args.paths, args.target, find_arguments=arguments)
+    apps = find_apps(args.paths, args.target, find_arguments=FindArguments.model_validate(kwargs_without_none))
+
     if isinstance(arguments, FindArguments):  # find only
         if arguments.output:
             os.makedirs(os.path.dirname(os.path.realpath(arguments.output)), exist_ok=True)
@@ -444,6 +447,12 @@ def main():
         for app in failed_apps:
             print(f'  {app}')
 
+    disabled_apps = [app for app in apps if app.build_status == BuildStatus.DISABLED]
+    if disabled_apps:
+        print('Disabled the following apps:')
+        for app in disabled_apps:
+            print(f'  {app}')
+
     if ret_code != 0:
         sys.exit(ret_code)
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/manifest/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 """

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/manifest/manifest.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import contextvars
 import logging
@@ -45,7 +45,7 @@ class IfClause:
         try:
             self.stmt: BoolStmt = parse_bool_expr(stmt)
             self._stmt: str = stmt
-        except (ParseException, InvalidIfClause) as ex:
+        except (ParseException, InvalidIfClause, AttributeError) as ex:
             raise InvalidIfClause(f'Invalid if clause: {stmt}. {ex}')
 
         self.temporary = temporary
@@ -342,12 +342,19 @@ class Manifest:
         self._rule_paths = {rule.folder: rule for rule in self.rules}
 
     @classmethod
-    def from_files(cls, paths: t.Iterable[PathLike], *, root_path: str = os.curdir) -> 'Manifest':
+    def from_files(
+        cls,
+        paths: t.Iterable[PathLike],
+        *,
+        root_path: str = os.curdir,
+        common_components: t.Optional[t.Sequence[str]] = None,
+    ) -> 'Manifest':
         """
         Create a Manifest instance from multiple manifest files
 
         :param paths: manifest file paths
         :param root_path: root path for relative paths in manifest files
+        :param common_components: sequence of strings to expand the ``- *common_components`` placeholder in manifests
         :return: Manifest instance
         """
         # folder, defined as dict
@@ -356,7 +363,7 @@ class Manifest:
         rules: t.List[FolderRule] = []
         for path in paths:
             LOGGER.debug('Loading manifest file %s', path)
-            _manifest = cls.from_file(path, root_path=root_path)
+            _manifest = cls.from_file(path, root_path=root_path, common_components=common_components)
 
             for rule in _manifest.rules:
                 if rule.folder in _known_folders:
@@ -373,15 +380,22 @@ class Manifest:
         return Manifest(rules, root_path=root_path)
 
     @classmethod
-    def from_file(cls, path: PathLike, *, root_path: str = os.curdir) -> 'Manifest':
+    def from_file(
+        cls,
+        path: PathLike,
+        *,
+        root_path: str = os.curdir,
+        common_components: t.Optional[t.Sequence[str]] = None,
+    ) -> 'Manifest':
         """
         Create a Manifest instance from a manifest file
 
         :param path: path to the manifest file
         :param root_path: root path for relative paths in manifest file
+        :param common_components: sequence of strings to expand the ``{{root_components}}`` placeholder in manifests
         :return: Manifest instance
         """
-        manifest_dict = parse(path)
+        manifest_dict = parse(path, common_components=common_components)
 
         rules: t.List[FolderRule] = []
         for folder, folder_rule in manifest_dict.items():

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/manifest/soc_header.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2025-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import esp_bool_parser

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/session_args.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import logging

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/utils.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import fnmatch

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/yaml/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 from .parser import (

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/idf_build_apps/yaml/parser.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import typing as t
@@ -62,8 +62,41 @@ def parse_postfixes(manifest_dict: t.Dict):
         manifest_dict[folder] = updated_folder
 
 
-def parse(path: PathLike) -> t.Dict:
-    with open(path) as f:
-        manifest_dict = yaml.safe_load(f) or {}
+def flatten_common_components(manifest_dict: t.Dict):
+    """
+    Flattens nested lists under `depends_components` into a single list of strings.
+    """
+
+    for folder, folder_rule in manifest_dict.items():
+        if not isinstance(folder_rule, t.Dict):
+            continue
+
+        depends = folder_rule.get('depends_components')
+        if not isinstance(depends, t.List):
+            continue
+
+        flattened: t.List[str] = []
+        for item in depends:
+            if isinstance(item, t.List):
+                flattened.extend(map(str, item))
+            else:
+                flattened.append(item)
+
+        folder_rule['depends_components'] = flattened
+
+
+def parse(path: PathLike, *, common_components: t.Optional[t.Sequence[str]] = None) -> t.Dict:
+    common_components_yaml = (
+        '.common_components: &common_components\n' + '\n'.join(f'  - {component}' for component in common_components)
+        if common_components
+        else ''
+    )
+
+    with open(path, encoding='utf-8') as f:
+        user_yaml = f.read()
+
+    manifest_dict = yaml.safe_load(f'{common_components_yaml}\n{user_yaml}') or {}
+
+    flatten_common_components(manifest_dict)
     parse_postfixes(manifest_dict)
     return manifest_dict

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/pyproject.toml

@@ -65,7 +65,7 @@ idf-build-apps = "idf_build_apps:main.main"
 
 [tool.commitizen]
 name = "czespressif"
-version = "2.13.3"
+version = "2.14.0"
 
 tag_format = "v$version"
 version_scheme = "pep440"
@@ -172,4 +172,4 @@ docstring-code-format = true
 ignore-variadic-names = true
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/setup.py

@@ -38,7 +38,7 @@ entry_points = \
 {'console_scripts': ['idf-build-apps = idf_build_apps:main.main']}
 
 setup(name='idf-build-apps',
-      version='2.13.3',
+      version='2.14.0',
       description='Tools for building ESP-IDF related apps.',
       author=None,
       author_email='Fu Hanxi <fuhanxi@espressif.com>',

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/conftest.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_app.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_args.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 from tempfile import NamedTemporaryFile
@@ -170,6 +170,20 @@ modified_files = [
     assert args.deactivate_dependency_driven_build_by_components == ['baz']
 
 
+def test_func_common_components():
+    with open(IDF_BUILD_APPS_TOML_FN, 'w') as fw:
+        fw.write("""
+common_components = [
+    'hello',
+    'world'
+]
+        """)
+
+    args = FindArguments()
+
+    assert args.common_components == ['hello', 'world']
+
+
 def test_combination_validation():
     """Test that target options can now be combined"""
     # Mock targets for consistent testing

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_build.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import json
@@ -253,7 +253,6 @@ class TestBuild:
 
         expected_files = [
             'libesp_timer.a:system_time.c.obj',
-            'libc.a:libc_a-vfprintf.o',
             'libfreertos.a:tasks.c.obj',
             'libheap.a:tlsf.c.obj',
         ]

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_cmd.py

@@ -1,11 +1,15 @@
-# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 import sys
 from pathlib import Path
+from textwrap import dedent
+from xml.etree import ElementTree
 
 import pytest
+from conftest import create_project
 
+from idf_build_apps.constants import SUPPORTED_TARGETS
 from idf_build_apps.main import main
 from idf_build_apps.utils import InvalidCommand
 
@@ -95,3 +99,65 @@ bar:
     assert f'Loading manifest file {os.path.join(tmp_path, "manifest.yml")}' in err
     assert f'"{os.path.join(tmp_path, "foo")}" does not exist' in err
     assert f'"{os.path.join(tmp_path, "bar")}" does not exist' in err
+
+
+def test_build_include_all_apps(tmp_path, monkeypatch, capsys):
+    create_project('foo', tmp_path)
+
+    manifest = tmp_path / 'manifest.yml'
+    manifest.write_text(
+        dedent("""\
+        foo:
+          disable:
+            - if: IDF_TARGET == "esp32"
+        """)
+    )
+
+    with monkeypatch.context() as m:
+        m.setattr(
+            sys,
+            'argv',
+            [
+                'idf-build-apps',
+                'build',
+                '--paths',
+                'foo',
+                '--manifest-files',
+                str(manifest),
+                '--check-manifest-rules',
+                '--include-all-apps',
+                '--junitxml',
+                str(tmp_path / 'junit.xml'),
+                '--dry-run',
+            ],
+        )
+        main()
+
+    out, err = capsys.readouterr()
+    assert err == ''
+    assert 'Disabled the following apps' in out
+    assert out.count('Disabled by manifest rule: IDF_TARGET == "esp32"') == 1
+
+    with open(str(tmp_path / 'junit.xml')) as f:
+        xml = ElementTree.fromstring(f.read())
+
+    test_suite = xml.findall('testsuite')[0]
+    assert test_suite.attrib['tests'] == '0'
+    assert test_suite.attrib['failures'] == '0'
+    assert test_suite.attrib['errors'] == '0'
+    assert test_suite.attrib['skipped'] == str(len(SUPPORTED_TARGETS))
+
+    disabled_testcases = 0
+
+    for case in test_suite.findall('testcase'):
+        if case.get('name') != 'foo/build':
+            continue
+
+        skipped = case.find('skipped')
+        if skipped is None:
+            continue
+
+        if skipped.get('message') == 'Disabled by manifest rule: IDF_TARGET == "esp32"':
+            disabled_testcases += 1
+
+    assert disabled_testcases == 1

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_disable_reasons.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2025-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_finder.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import os
@@ -138,7 +138,7 @@ examples/get-started:
         for app in apps:
             assert app.build_status == BuildStatus.DISABLED
             app.build()
-            assert app.build_comment == 'Build disabled. Skipping...'
+            assert app.build_comment.startswith('Not enabled by manifest rules:')
 
 
 class TestFindWithModifiedFilesComponents:

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_manifest.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 
@@ -176,6 +176,33 @@ test5:
         assert manifest.depends_components('test5', 'esp32', '123123') == ['some_1', 'some_2', 'some_3']
         assert manifest.depends_components('test5', None, None) == ['some_1', 'some_2', 'some_3']
 
+    def test_manifest_common_components(self, tmp_path):
+        common_components = ['hello', 'world', 123]
+
+        yaml_file = tmp_path / 'test.yml'
+        yaml_file.write_text(
+            """
+test5:
+  depends_components:
+    - *common_components
+    - "some_1"
+    - "some_2"
+    - "some_3"
+
+""",
+            encoding='utf8',
+        )
+
+        manifest = Manifest.from_file(yaml_file, common_components=common_components)
+        assert manifest.depends_components('test5', None, None) == [
+            'hello',
+            'world',
+            '123',
+            'some_1',
+            'some_2',
+            'some_3',
+        ]
+
     def test_manifest_switch_clause_with_postfix(self, tmp_path):
         yaml_file = tmp_path / 'test.yml'
 

{idf_build_apps-2.13.3 → idf_build_apps-2.14.0}/tests/test_utils.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2026 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import os
 from pathlib import (