idf-build-apps 2.5.3__py3-none-any.whl → 2.6.1__py3-none-any.whl

idf_build_apps/__init__.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2025 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.5.3'
+__version__ = '2.6.1'
 
 from .session_args import (
     SessionArgs,

idf_build_apps/args.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import argparse
@@ -27,7 +27,7 @@ from pydantic_settings import (
 from typing_extensions import Concatenate, ParamSpec
 
 from . import SESSION_ARGS, App, setup_logging
-from .constants import ALL_TARGETS
+from .constants import ALL_TARGETS, IDF_BUILD_APPS_TOML_FN
 from .manifest.manifest import FolderRule, Manifest
 from .utils import InvalidCommand, files_matches_patterns, semicolon_separated_str_to_list, to_absolute_path, to_list
 from .vendors.pydantic_sources import PyprojectTomlConfigSettingsSource, TomlConfigSettingsSource
@@ -37,6 +37,7 @@ LOGGER = logging.getLogger(__name__)
 
 class ValidateMethod(str, enum.Enum):
     TO_LIST = 'to_list'
+    EXPAND_VARS = 'expand_vars'
 
 
 @dataclass
@@ -114,11 +115,13 @@ def get_meta(f: FieldInfo) -> t.Optional[FieldMetadata]:
 class BaseArguments(BaseSettings):
     """Base settings class for all settings classes"""
 
+    CONFIG_FILE_PATH: t.ClassVar[t.Optional[Path]] = None
+
     model_config = SettingsConfigDict(
-        toml_file='.idf_build_apps.toml',
+        # these below two are supported in pydantic 2.6
         pyproject_toml_table_header=('tool', 'idf-build-apps'),
         pyproject_toml_depth=sys.maxsize,
-        extra='ignore',
+        extra='ignore',  # we're supporting pydantic <2.6 as well, so we ignore extra fields
     )
 
     @classmethod
@@ -130,11 +133,15 @@ class BaseArguments(BaseSettings):
         dotenv_settings: PydanticBaseSettingsSource,  # noqa: ARG003
         file_secret_settings: PydanticBaseSettingsSource,  # noqa: ARG003
     ) -> t.Tuple[PydanticBaseSettingsSource, ...]:
-        return (
-            init_settings,
-            TomlConfigSettingsSource(settings_cls),
-            PyprojectTomlConfigSettingsSource(settings_cls),
-        )
+        sources: t.Tuple[PydanticBaseSettingsSource, ...] = (init_settings,)
+        if cls.CONFIG_FILE_PATH is None:
+            sources += (TomlConfigSettingsSource(settings_cls, toml_file=Path(IDF_BUILD_APPS_TOML_FN)),)
+            sources += (PyprojectTomlConfigSettingsSource(settings_cls, toml_file=Path('pyproject.toml')),)
+        else:
+            sources += (TomlConfigSettingsSource(settings_cls, toml_file=Path(cls.CONFIG_FILE_PATH)),)
+            sources += (PyprojectTomlConfigSettingsSource(settings_cls, toml_file=Path(cls.CONFIG_FILE_PATH)),)
+
+        return sources
 
     @field_validator('*', mode='before')
     @classmethod
@@ -143,8 +150,15 @@ class BaseArguments(BaseSettings):
             f = cls.model_fields[info.field_name]
             meta = get_meta(f)
             if meta and meta.validate_method:
-                if ValidateMethod.TO_LIST in meta.validate_method:
-                    return to_list(v)
+                for method in meta.validate_method:
+                    if method == ValidateMethod.TO_LIST:
+                        v = to_list(v)
+                    elif method == ValidateMethod.EXPAND_VARS:
+                        v = os.path.expandvars(v)
+                    else:
+                        raise NotImplementedError(f'Unknown validate method: {method}')
+
+                return v
 
         return v
 
@@ -156,19 +170,19 @@ class GlobalArguments(BaseArguments):
             action='count',
         ),
         description='Verbosity level. By default set to WARNING. Specify -v for INFO, -vv for DEBUG',
-        default=0,
+        default=0,  # type: ignore
     )
     log_file: t.Optional[str] = field(
         None,
         description='Path to the log file, if not specified logs will be printed to stderr',
-        default=None,
+        default=None,  # type: ignore
     )
     no_color: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Disable colored output',
-        default=False,
+        default=False,  # type: ignore
     )
 
     def model_post_init(self, __context: Any) -> None:
@@ -190,7 +204,7 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         ),
         description='Path to the manifest files which contains the build test rules of the apps',
         validation_alias=AliasChoices('manifest_files', 'manifest_file'),
-        default=None,
+        default=None,  # type: ignore
     )
     manifest_filepatterns: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -199,13 +213,15 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         ),
         description='space-separated list of file patterns to search for the manifest files. '
         'The matched files will be loaded as the manifest files.',
-        default=None,
+        default=None,  # type: ignore
     )
     manifest_rootpath: str = field(
-        None,
+        FieldMetadata(
+            validate_method=[ValidateMethod.EXPAND_VARS],
+        ),
         description='Root path to resolve the relative paths defined in the manifest files. '
-        'By default set to the current directory',
-        default=os.curdir,
+        'By default set to the current directory. Support environment variables.',
+        default=os.curdir,  # type: ignore
     )
     modified_components: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -215,7 +231,7 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         description='semicolon-separated list of 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,
+        default=None,  # type: ignore
     )
     modified_files: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -225,7 +241,7 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         description='semicolon-separated list of modified files. '
         'If set to "", the value would be considered as None. '
         'If set to ";", the value would be considered as an empty list.',
-        default=None,
+        default=None,  # type: ignore
     )
     deactivate_dependency_driven_build_by_components: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -247,7 +263,7 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         validation_alias=AliasChoices(
             'deactivate_dependency_driven_build_by_components', 'ignore_app_dependencies_components'
         ),
-        default=None,
+        default=None,  # type: ignore
     )
     deactivate_dependency_driven_build_by_filepatterns: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -269,21 +285,21 @@ class DependencyDrivenBuildArguments(GlobalArguments):
         validation_alias=AliasChoices(
             'deactivate_dependency_driven_build_by_filepatterns', 'ignore_app_dependencies_filepatterns'
         ),
-        default=None,
+        default=None,  # type: ignore
     )
     check_manifest_rules: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Check if all folders defined in the manifest files exist. Fail if not',
-        default=False,
+        default=False,  # type: ignore
     )
     compare_manifest_sha_filepath: t.Optional[str] = field(
         None,
         description='Path to the file containing the hash of the manifest rules. '
         'Compare the hash with the current manifest rules. '
         'All matched apps will be built if the corresponding manifest rule is modified',
-        default=None,
+        default=None,  # type: ignore
     )
 
     def model_post_init(self, __context: Any) -> None:
@@ -377,28 +393,28 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
             nargs='*',
         ),
         description='Paths to the directories containing the apps. By default set to the current directory',
-        default=os.curdir,
+        default=os.curdir,  # type: ignore
     )
     target: str = field(
         FieldMetadata(
             shorthand='-t',
         ),
         description='Filter the apps by target. By default set to "all"',
-        default='all',
+        default='all',  # type: ignore
     )
     build_system: t.Union[str, t.Type[App]] = field(
         FieldMetadata(
             choices=['cmake', 'make'],
         ),
         description='Filter the apps by build system. By default set to "cmake"',
-        default='cmake',
+        default='cmake',  # type: ignore
     )
     recursive: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Search for apps recursively under the specified paths',
-        default=False,
+        default=False,  # type: ignore
     )
     exclude: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -407,20 +423,20 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         ),
         description='Ignore the specified directories while searching recursively',
         validation_alias=AliasChoices('exclude', 'exclude_list'),
-        default=None,
+        default=None,  # type: ignore
     )
     work_dir: t.Optional[str] = field(
         None,
         description='Copy the app to this directory before building. '
         'By default set to the app directory. Can expand placeholders',
-        default=None,
+        default=None,  # type: ignore
     )
     build_dir: str = field(
         None,
         description='Build directory for the app. By default set to "build". '
         'When set to relative path, it will be treated as relative to the app directory. '
         'Can expand placeholders',
-        default='build',
+        default='build',  # type: ignore
     )
     build_log_filename: t.Optional[str] = field(
         FieldMetadata(
@@ -428,7 +444,7 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         ),
         description='Log filename under the build directory instead of stdout. Can expand placeholders',
         validation_alias=AliasChoices('build_log_filename', 'build_log'),
-        default=None,
+        default=None,  # type: ignore
     )
     size_json_filename: t.Optional[str] = field(
         FieldMetadata(
@@ -436,7 +452,7 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         ),
         description='`idf.py size` output file under the build directory when specified. ' 'Can expand placeholders',
         validation_alias=AliasChoices('size_json_filename', 'size_file'),
-        default=None,
+        default=None,  # type: ignore
     )
     config_rules: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -454,31 +470,31 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         'FILEPATTERN is the filename of the sdkconfig file with a single wildcard character (*). '
         'The NAME is the value matched by the wildcard',
         validation_alias=AliasChoices('config_rules', 'config_rules_str', 'config'),
-        default=None,
+        default=None,  # type: ignore
     )
     override_sdkconfig_items: t.Optional[str] = field(
         None,
         description='A comma-separated list of key=value pairs to override the sdkconfig items',
-        default=None,
+        default=None,  # type: ignore
     )
     override_sdkconfig_files: t.Optional[str] = field(
         None,
         description='A comma-separated list of sdkconfig files to override the sdkconfig items. '
         'When set to relative path, it will be treated as relative to the current directory',
-        default=None,
+        default=None,  # type: ignore
     )
     sdkconfig_defaults: t.Optional[str] = field(
         None,
         description='A semicolon-separated list of sdkconfig files passed to `idf.py -DSDKCONFIG_DEFAULTS`. '
         'SDKCONFIG_DEFAULTS environment variable is used when not specified',
-        default=os.getenv('SDKCONFIG_DEFAULTS', None),
+        default=os.getenv('SDKCONFIG_DEFAULTS', None),  # type: ignore
     )
     check_warnings: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Check for warnings in the build output. Fail if any warnings are found',
-        default=False,
+        default=False,  # type: ignore
     )
     default_build_targets: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -487,7 +503,7 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         ),
         description='space-separated list of the default enabled build targets for the apps. '
         'When not specified, the default value is the targets listed by `idf.py --list-targets`',
-        default=None,
+        default=None,  # type: ignore
     )
     enable_preview_targets: bool = field(
         FieldMetadata(
@@ -495,28 +511,28 @@ class FindBuildArguments(DependencyDrivenBuildArguments):
         ),
         description='When enabled, the default build targets will be set to all apps, '
         'including the preview targets. As the targets defined in `idf.py --list-targets --preview`',
-        default=False,
+        default=False,  # type: ignore
     )
     include_skipped_apps: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Include the skipped apps in the output, together with the enabled ones',
-        default=False,
+        default=False,  # type: ignore
     )
     include_disabled_apps: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Include the disabled apps in the output, together with the enabled ones',
-        default=False,
+        default=False,  # type: ignore
     )
     include_all_apps: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Include skipped, and disabled apps in the output, together with the enabled ones',
-        default=False,
+        default=False,  # type: ignore
     )
 
     def model_post_init(self, __context: Any) -> None:
@@ -557,7 +573,7 @@ class FindArguments(FindBuildArguments):
             shorthand='-o',
         ),
         description='Record the found apps to the specified file instead of stdout',
-        default=None,
+        default=None,  # type: ignore
     )
     output_format: str = field(
         FieldMetadata(
@@ -566,7 +582,7 @@ class FindArguments(FindBuildArguments):
         description='Output format of the found apps. '
         'In "raw" format, each line is a json string serialized from the app model. '
         'In "json" format, the output is a json list of the serialized app models',
-        default='raw',
+        default='raw',  # type: ignore
     )
 
     def model_post_init(self, __context: Any) -> None:
@@ -587,7 +603,7 @@ class BuildArguments(FindBuildArguments):
             action='store_true',
         ),
         description='Enable verbose output of the build system',
-        default=False,
+        default=False,  # type: ignore
     )
     parallel_count: int = field(
         FieldMetadata(
@@ -597,7 +613,7 @@ class BuildArguments(FindBuildArguments):
         'Specified together with --parallel-index. '
         'The given apps will be divided into parallel_count parts, '
         'and the current run will build the parallel_index-th part',
-        default=1,
+        default=1,  # type: ignore
     )
     parallel_index: int = field(
         FieldMetadata(
@@ -607,28 +623,28 @@ class BuildArguments(FindBuildArguments):
         'Specified together with --parallel-count. '
         'The given apps will be divided into parallel_count parts, '
         'and the current run will build the parallel_index-th part',
-        default=1,
+        default=1,  # type: ignore
     )
     dry_run: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Skip the actual build, only print the build process',
-        default=False,
+        default=False,  # type: ignore
     )
     keep_going: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Continue building the next app when the current build fails',
-        default=False,
+        default=False,  # type: ignore
     )
     no_preserve: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Do not preserve the build directory after a successful build',
-        default=False,
+        default=False,  # type: ignore
     )
     ignore_warning_strs: t.Optional[t.List[str]] = field(
         FieldMetadata(
@@ -641,7 +657,7 @@ class BuildArguments(FindBuildArguments):
         description='space-separated list of patterns. '
         'Ignore the warnings in the build output that match the patterns',
         validation_alias=AliasChoices('ignore_warning_strs', 'ignore_warning_str'),
-        default=None,
+        default=None,  # type: ignore
     )
     ignore_warning_files: t.Optional[t.List[t.Union[str, TextIOWrapper]]] = field(
         FieldMetadata(
@@ -656,14 +672,14 @@ class BuildArguments(FindBuildArguments):
         ),
         description='Path to the files containing the patterns to ignore the warnings in the build output',
         validation_alias=AliasChoices('ignore_warning_files', 'ignore_warning_file'),
-        default=None,
+        default=None,  # type: ignore
     )
     copy_sdkconfig: bool = field(
         FieldMetadata(
             action='store_true',
         ),
         description='Copy the sdkconfig file to the build directory',
-        default=False,
+        default=False,  # type: ignore
     )
 
     # Attrs that support placeholders
@@ -675,7 +691,7 @@ class BuildArguments(FindBuildArguments):
         description='Record size json filepath of the built apps to the specified file. '
         'Each line is a json string. Can expand placeholders @p',
         validation_alias=AliasChoices('collect_size_info_filename', 'collect_size_info'),
-        default=None,
+        default=None,  # type: ignore
         exclude=True,  # computed field is used
     )
     collect_app_info_filename: t.Optional[str] = field(
@@ -686,7 +702,7 @@ class BuildArguments(FindBuildArguments):
         description='Record serialized app model of the built apps to the specified file. '
         'Each line is a json string. Can expand placeholders @p',
         validation_alias=AliasChoices('collect_app_info_filename', 'collect_app_info'),
-        default=None,
+        default=None,  # type: ignore
         exclude=True,  # computed field is used
     )
     junitxml_filename: t.Optional[str] = field(
@@ -696,7 +712,7 @@ class BuildArguments(FindBuildArguments):
         ),
         description='Path to the junitxml file to record the build results. Can expand placeholder @p',
         validation_alias=AliasChoices('junitxml_filename', 'junitxml'),
-        default=None,
+        default=None,  # type: ignore
         exclude=True,  # computed field is used
     )
     # used for expanding placeholders
@@ -753,7 +769,7 @@ class DumpManifestShaArguments(GlobalArguments):
             required=True,
         ),
         description='Path to the manifest files which contains the build test rules of the apps',
-        default=None,
+        default=None,  # type: ignore
     )
 
     output: t.Optional[str] = field(
@@ -762,7 +778,7 @@ class DumpManifestShaArguments(GlobalArguments):
             required=True,
         ),
         description='Path to the output file to record the sha256 hash of the manifest rules',
-        default=None,
+        default=None,  # type: ignore
     )
 
     def model_post_init(self, __context: Any) -> None:
@@ -863,12 +879,20 @@ def add_args_to_obj_doc_as_params(argument_cls: t.Type[GlobalArguments], obj: t.
     _obj.__doc__ = _doc_str
 
 
-def apply_config_file(config_file: t.Optional[str]) -> None:
+def apply_config_file(config_file: t.Optional[str] = None, reset: bool = False) -> None:
     def _subclasses(klass: t.Type[T]) -> t.Set[t.Type[T]]:
         return set(klass.__subclasses__()).union([s for c in klass.__subclasses__() for s in _subclasses(c)])
 
-    if config_file:
-        BaseArguments.model_config['toml_file'] = str(config_file)
-        # modify all subclasses
+    if reset:
+        BaseArguments.CONFIG_FILE_PATH = None
         for cls in _subclasses(BaseArguments):
-            cls.model_config['toml_file'] = str(config_file)
+            cls.CONFIG_FILE_PATH = None
+
+    if config_file:
+        if os.path.isfile(config_file):
+            p = Path(config_file)
+            BaseArguments.CONFIG_FILE_PATH = p
+            for cls in _subclasses(BaseArguments):
+                cls.CONFIG_FILE_PATH = p
+        else:
+            LOGGER.warning(f'Config file {config_file} does not exist. Ignoring...')

idf_build_apps/constants.py

@@ -1,70 +1,25 @@
-# SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import enum
-import importlib
-import logging
 import os
-import re
-import sys
-import typing as t
 
-from .utils import (
-    to_version,
-)
+import esp_bool_parser
 
-LOGGER = logging.getLogger(__name__)
-
-_idf_env = os.getenv('IDF_PATH') or ''
-if not _idf_env:
-    LOGGER.warning('IDF_PATH environment variable is not set. Entering test mode...')
-    LOGGER.warning('- Setting IDF_PATH to current directory...')
-IDF_PATH = os.path.abspath(_idf_env)
+IDF_PATH = esp_bool_parser.IDF_PATH
 IDF_PY = os.path.join(IDF_PATH, 'tools', 'idf.py')
 IDF_SIZE_PY = os.path.join(IDF_PATH, 'tools', 'idf_size.py')
+
 PROJECT_DESCRIPTION_JSON = 'project_description.json'
 DEFAULT_SDKCONFIG = 'sdkconfig.defaults'
 
-
-_idf_py_actions = os.path.join(IDF_PATH, 'tools', 'idf_py_actions')
-sys.path.append(_idf_py_actions)
-try:
-    _idf_py_constant_py = importlib.import_module('constants')
-except ModuleNotFoundError:
-    LOGGER.warning(
-        '- Set supported/preview targets to empty list... (ESP-IDF constants.py module not found under %s)',
-        _idf_py_actions,
-    )
-    _idf_py_constant_py = object()  # type: ignore
-SUPPORTED_TARGETS = getattr(_idf_py_constant_py, 'SUPPORTED_TARGETS', [])
-PREVIEW_TARGETS = getattr(_idf_py_constant_py, 'PREVIEW_TARGETS', [])
-ALL_TARGETS = SUPPORTED_TARGETS + PREVIEW_TARGETS
-
-
-def _idf_version_from_cmake() -> t.Tuple[int, int, int]:
-    version_path = os.path.join(IDF_PATH, 'tools', 'cmake', 'version.cmake')
-    if not os.path.isfile(version_path):
-        LOGGER.warning('- Setting ESP-IDF version to 1.0.0... (ESP-IDF version.cmake not exists at %s)', version_path)
-        return 1, 0, 0
-
-    regex = re.compile(r'^\s*set\s*\(\s*IDF_VERSION_([A-Z]{5})\s+(\d+)')
-    ver = {}
-    try:
-        with open(version_path) as f:
-            for line in f:
-                m = regex.match(line)
-
-                if m:
-                    ver[m.group(1)] = m.group(2)
-
-        return int(ver['MAJOR']), int(ver['MINOR']), int(ver['PATCH'])
-    except (KeyError, OSError):
-        raise ValueError(f'Cannot find ESP-IDF version in {version_path}')
-
-
-IDF_VERSION_MAJOR, IDF_VERSION_MINOR, IDF_VERSION_PATCH = _idf_version_from_cmake()
-
-IDF_VERSION = to_version(f'{IDF_VERSION_MAJOR}.{IDF_VERSION_MINOR}.{IDF_VERSION_PATCH}')
+SUPPORTED_TARGETS = esp_bool_parser.SUPPORTED_TARGETS
+PREVIEW_TARGETS = esp_bool_parser.PREVIEW_TARGETS
+ALL_TARGETS = esp_bool_parser.ALL_TARGETS
+IDF_VERSION_MAJOR = esp_bool_parser.IDF_VERSION_MAJOR
+IDF_VERSION_MINOR = esp_bool_parser.IDF_VERSION_MINOR
+IDF_VERSION_PATCH = esp_bool_parser.IDF_VERSION_PATCH
+IDF_VERSION = esp_bool_parser.IDF_VERSION
 
 
 class BuildStatus(str, enum.Enum):

idf_build_apps/finder.py

@@ -50,6 +50,7 @@ def _get_apps_from_path(
 
         # for unknown ones, we keep them to the build stage to judge
         if _app.build_status == BuildStatus.SKIPPED:
+            LOGGER.debug('=> Skipped. Reason: %s', _app.build_comment or 'Unknown')
             return args.include_skipped_apps
 
         return True

idf_build_apps/junit/utils.py

@@ -28,7 +28,7 @@ def get_processor_name():
             with open('/proc/cpuinfo') as f:
                 for line in f:
                     if 'model name' in line:
-                        return re.sub('.*model name.*:', '', line, 1).strip()
+                        return re.sub('.*model name.*:', '', line, count=1).strip()
         except Exception:
             pass
 

idf_build_apps/main.py

@@ -1,6 +1,6 @@
 # PYTHON_ARGCOMPLETE_OK
 
-# SPDX-FileCopyrightText: 2022-2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 import argparse
@@ -68,7 +68,8 @@ def find_apps(
 
     :return: list of found apps
     """
-    apply_config_file(config_file)
+    if config_file:
+        apply_config_file(config_file)
 
     # compatible with old usage
     ## `preserve`
@@ -132,7 +133,8 @@ def build_apps(
 
     :return: exit code
     """
-    apply_config_file(config_file)
+    if config_file:
+        apply_config_file(config_file)
 
     # compatible with old usage
     ## `check_app_dependencies`
@@ -385,8 +387,8 @@ def main():
     kwargs = vars(args)
     action = kwargs.pop('action')
     config_file = kwargs.pop('config_file')
-
-    apply_config_file(config_file)
+    if config_file:
+        apply_config_file(config_file)
 
     if action == 'dump-manifest-sha':
         arguments = DumpManifestShaArguments(**drop_none_kwargs(kwargs))

idf_build_apps/manifest/__init__.py

@@ -1,6 +1,17 @@
-# SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2022-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 
 """
 Manifest file
 """
+
+from esp_bool_parser import register_addition_attribute
+
+from .manifest import FolderRule
+
+
+def folder_rule_attr(target, **kwargs):
+    return 1 if target in FolderRule.DEFAULT_BUILD_TARGETS else 0
+
+
+register_addition_attribute('INCLUDE_DEFAULT', folder_rule_attr)