IDF Component Manager v3.1.0 (2026-07-14)

PyPI release: https://pypi.org/project/idf-component-manager/3.1.0/

CLI

• Introduced functionality to install root-managed components based on the idf_extra_components.yml file (025fe3f)
• Adopted esp-pylib for shared errors, hints and IDE diagnostics (fe5f9d4)
• Migrated from click to rich-click in order to get a similar CLI experience with ESP-IDF ecosystem (fe5f9d4)
• Added validation for example paths and project names to ensure compliance with cross-platform filename rules, preventing the use of disallowed characters and reserved names. (c00fee3)
• Added a new manifest lint command to help validate manifest files. (92dce3a)

ESP-IDF Integration

• Added support for using installed root-managed components during project configuration and build (f69f124)

Library

• Added a versioned root-managed component storage model (9b6fd53)
• Added a changelog field to the component manifest (fb94ed1)

Solver

• Added functionality to override dependencies in the dependency tree, providing users with greater flexibility in managing their project requirements (41eedcb)

IDF Component Manager v3.0.3 (2026-06-09)

PyPI release: https://pypi.org/project/idf-component-manager/3.0.3/

Component Sources

• Fixed the issue where git would not function on a bare repository when safe.bareRepository was set to explicit. (e9327d5)
• Add self-healing for broken bare-repos in the cache (041872c)

Library

• Addressed multiple deprecation warnings in if_parser.py by replacing outdated Pyparsing functions (4b756b1)

Solver

• Fixed the issue where idf.py --version was called for each manifest during compote registry sync, resulting in a 3.5x speed improvement. (8d1940b)
• Updated dependencies.lock to consistently use POSIX separators for local paths (2978295)
• Fixed a bug that caused global KCONFIG_CONTEXT.missed_keys to be altered during candidate evaluation, which led to false-positive CMake retries. (0a34980)
• Fixed a crash in the version solver's error message formatter by eliminatinating outdated details parameters from the _visit() method calls. (8fc7b69)

IDF Component Manager v3.0.2 (2026-04-22)

PyPI release: https://pypi.org/project/idf-component-manager/3.0.2/

ESP-IDF Integration

• Changed the logging level for successful git stderr messages from WARNING to DEBUG (551e2ca)

Library

• Fixed the warning messages related to Pydantic serialization that appeared during EIM installation. (778217b)
• Updated the handling of local_storage_url by merging it with the IDF_COMPONENT_LOCAL_STORAGE_URL environment variable, prioritizing user-defined configurations. (8fe435c)

Solver

• Fix for override_path for registry dependencies inside Git repositories, allowing components within the same repository to be resolved correctly. (c013752)

IDF Component Manager v3.0.1 (2026-03-30)

PyPI release: https://pypi.org/project/idf-component-manager/3.0.1/

Solver

• Skipped the download of root managed components when idf_extra_components.yml file has no dependencies defined

IDF Component Manager v3.0.0 (2026-03-16)

PyPI release: https://pypi.org/project/idf-component-manager/3.0.0/

Breaking changes (Supports ESP-IDF >= 6.0.0)

ESP-IDF Integration

• Remove support for older versions of the ESP-IDF (d8760250)
• Introduce new interface version for Component Manager in IDF Build System to shift responsibility for KConfig resolution back to ESP-IDF (a7c40080)
• Added support for using the full ESP-IDF version in the paths for idf_managed_components directories. (12b88dbf)

Library

• Use relative path for local source in dependencies.lock (b8d52494)
• Drop support for python versions older than 3.10 (c57fec24)
• Remove IDF_COMPONENT_KNOWN_TARGETS and IDF_COMPONENT_MANAGER_KNOWN_TARGETS environment variables (c58570de)

---

Changes

CLI

• Fix JSONDecodeError on API issues on during component uploads (6a578a14)
• Add idf.py remove-dependency command (86d4137b)
• Remove known targets check before uploading a component to the registry (c58570de)
• Combine (not overwrite) requirements when creating a partial mirror (66a8a95f)
• Add --profile CLI argument validation (78519a48)

Documentation

• Reorganized the documentation to differentiate between component consumers and uploaders, following a flattened Diataxis structure for clearer guidance. (4a958df3)
• Added reference documentation for the component files associated with component uploads. (02c8a9a0)
• Clarifies visibility and availability of KConfig symbols (c4adbbee)

ESP-IDF Integration

• Fix incorrect sources for dependencies in the lock file, when KConfig conditions are used (88780500)
• Use sdkconfig.json from known location inside build directory (19e2ad64)
• Prevent the Component Manager from using a stale sdkconfig.json. The dependency solver may now run up to three times to download components dependent on newly introduced Kconfig options. (6ce2234a)
• Recognize CMake v2 project level CMake files (7ddd3749)
• Show notice when KConfig options are used on unsupported ESP-IDF version (d3e4af52)
• Add remove-dependency command to idf.py (7158519d)
• Fix how IDF Component Manager works with sdkconfig.json in CMakeV2 (ee06726f)
• Remove support for older versions of the ESP-IDF (d8760250)
• Fixes order of dependencies in BUILD_COMPONENT_TARGETS when KConfig is used (37076c52)
• Fixes a case where Component Manager used a stale sdkconfig.json on Windows. (0f189a39)
• Introduce new interface version for Component Manager in IDF Build System to shift responsibility for KConfig resolution back to ESP-IDF (a7c40080)
• Fixed the issue where sdkconfig options were not preserved across multiple Component Manager runs when using KConfig options. (25308fb4)
• Ensured that the missing KConfig option warning appears only on the last unsuccessful run. (03d6dc1d)
• Resolved an issue where metadata files in root-managed components were incorrectly flagged as unexpected. (cb9dc509)
• Fixes warning emitting for undefined KConfig symbols when using CMake Build System v2 (6e28451f)
• Added support for using the full ESP-IDF version in the paths for idf_managed_components directories. (12b88dbf)

Library

• Use relative path for local source in dependencies.lock (b8d52494)
• Drop support for python versions older than 3.10 (c57fec24)
• Fix empty directory name in archives produced by compote component pack (2ac37177)
• Normalize case for ESP Component Registry components containing uppercase letters (35adb362)
• Remove IDF_COMPONENT_KNOWN_TARGETS and IDF_COMPONENT_MANAGER_KNOWN_TARGETS environment variables (c58570de)
• Fixed duplicate requests to the same storage endpoint when multiple storage sources share the same URL. Storage clients are now deduplicated by URL. (0db9632e)

Solver

• Make solver error messages more concise and declarative (30d9989f)
• Always solve dependencies when target changes and project depends on KConfig options (aa723e08)
• Fix the case, when web source component was pulled together with local alternative (491a6756)

IDF Component Manager v2.5.2 (2026-09-02)

PyPI release: https://pypi.org/project/idf-component-manager/2.5.2/

Component Sources

• Addressed the issue causing false name warnings for Git dependencies located at the repository root (0d88f2e8)

IDF Component Manager v2.5.1 (2026-09-01)

PyPI release: https://pypi.org/project/idf-component-manager/2.5.1/

Component Sources

• Fixed the issue where local paths within git dependencies could not be resolved. (ec7e663)

Library

• Fixed the issue where Semantic Version coercing failed to apply the revision suffix (17e877f)

IDF Component Manager v2.5.0 (2026-07-14)

PyPI release: https://pypi.org/project/idf-component-manager/2.5.0/

CLI

• Added validation for example paths and project names to ensure compliance with cross-platform filename rules, preventing the use of disallowed characters and reserved names. (399618a)

Solver

• Added functionality to override dependencies in the dependency tree, providing users with greater flexibility in managing their project requirements (20e0f9b)

IDF Component Manager v2.4.11 (2026-06-09)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.11/

Component Sources

• Fixed the issue where git would not function on a bare repository when safe.bareRepository was set to explicit. (c6eef51)
• Add self-healing for broken bare-repos in the cache (c50291a)

Solver

• Fixed the issue where idf.py --version was called for each manifest during compote registry sync, resulting in a 3.5x speed improvement. (e5c66f0)
• Fixed a bug that caused global KCONFIG_CONTEXT.missed_keys to be altered during candidate evaluation, which led to false-positive CMake retries. (b92ccac)
• Fixed a crash in the version solver's error message formatter by eliminating outdated details parameters from the _visit() method calls. (37ce21c)

IDF Component Manager v2.4.10 (2026-04-22)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.10/

ESP-IDF Integration

• Changed the logging level for successful git stderr messages from WARNING to DEBUG (2d05db6)

Library

• Fixed the warning messages related to Pydantic serialization that appeared during EIM installation. (f9c6810)
• Updated the handling of local_storage_url by merging it with the IDF_COMPONENT_LOCAL_STORAGE_URL environment variable, prioritizing user-defined configurations. (7a9cea6)

Solver

• Fix for override_path for registry dependencies inside Git repositories, allowing components within the same repository to be resolved correctly. (b8cbfe4)

IDF Component Manager v2.4.9 (2026-04-02)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.9/

ESP-IDF Integration

• Adjusted the file copying method to COPYONLY to ensure compatibility with older CMake versions (aaff531e)

IDF Component Manager v2.4.8 (2026-03-11)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.8/

Changes

ESP-IDF Integration

• Resolved an issue where metadata files in root-managed components were incorrectly flagged as unexpected. (193f837c)
• Fixes warning emitting for undefined KConfig symbols when using CMake Build System v2 (5da1fa07)

IDF Component Manager v2.4.7 (2026-03-02)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.7/

Changes

ESP-IDF Integration

• Fixed the issue where sdkconfig options were not preserved across multiple Component Manager runs when using KConfig options. (1b1fb643)
• Ensured that the missing KConfig option warning appears only on the last unsuccessful run. (8bbfdf83)

IDF Component Manager v2.4.6 (2025-01-22)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.6/

Changes

CLI

• Combine (not overwrite) requirements when creating a partial mirror (6e6a38e6)
• Add --profile CLI argument validation (8fa96552)

IDF Component Manager v2.4.5 (2025-01-16)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.5/

Changes

ESP-IDF Integration

• Fix handling of sdkconfig.json in CMakeV2 by the IDF Component Manager (7563951d)
• Prevent the Component Manager on Windows from using a stale sdkconfig.json (cad54053)

PyPI release: https://pypi.org/project/idf-component-manager/2.4.4/

Changes

ESP-IDF Integration

• Fixes order of dependencies in BUILD_COMPONENT_TARGETS when KConfig is used (6da2f98b)

Solver

• Fix the case, when web source component was pulled together with local alternative (fd955055)

IDF Component Manager v2.4.3

https://pypi.org/project/idf-component-manager/2.4.3/

CLI

• Fix JSONDecodeError on API issues on during component uploads (6024ad35)

ESP-IDF Integration

• Prevent the Component Manager from using a stale sdkconfig.json. The dependency solver may now run up to three times to download components dependent on newly introduced Kconfig options. (7a0bbc05)
• Show notice when KConfig options are used on unsupported ESP-IDF version (ac401998)
• Use sdkconfig.json from known location inside build directory (ea32cda8)
• Fix incorrect sources for dependencies in the lock file, when KConfig conditions are used (bd88528e)

Library

• Fix empty directory name in archives produced by compote component pack (898d8127)

Solver

• Make solver error messages more concise and declarative (448d8b8c)

v2.4.2 (2025-10-20)

Fix

• Local dependency hash key equivalence

v2.4.1 (2025-10-08)

Fix

• Do not install pydantic 2.12.0 as dependency due to bug
• remove deprecated click.__version__

Feat

• support idf root deps, handle it in idf build system
• support constraint file

Fix

• Error message regex in yank test

v2.3.0 (2025-08-13)

https://pypi.org/project/idf-component-manager/2.3.0/

Feat

• add service profile as global option to idf.py
• add --registry-url and --storage-url params to idf.py
• add IDF_COMPONENT_LOCAL_STORAGE_URL env variable
• add function to validate url or file in cli
• add --local-storage-url param to idf.py
• use pydantic types for validation
• read env variables in ProfileItem
• create mermaid workflow diagrams
• Add optional path to ChecksumsManager dump method

Fix

• cache message about skipped dependency
• better error message when manifest validation failed
• Allow to delete a yanked version
• Cassette when yanking
• Minor documentation fix
• ignore if clauses with kconfig options with unsupported idf version
• catch all MissingKconfigError exception
• fix checking max name length

Refactor

• reformat all rst files using docstrfmt

v2.2.2 (2025-06-12)

Feat

• Better report for corrupted component error message

Fix

• fix versions case sensitivity
• use ComponentRequirements in set
• Do not duplicate examples defined in the manifest when packing multiple times
• idf version regex supports >10
• root-level managed components folder path

v2.2.1 (2025-06-04)

https://pypi.org/project/idf-component-manager/2.2.1/

Fix

• file existence check during checksums validation

YANKED - Issue with downloaded components integrity check

https://pypi.org/project/idf-component-manager/2.2.0/

v2.2.0 (2025-06-02)

Feat

• cli: add commands to edit config
• improve kconfig item debug message
• use cmake syntax to represent kconfig option $CONFIG{...}
• Upload examples defined in manifest separately
• download component files hash from registry
• rewrite validate functions
• add util functions to create and parse file with checksums
• remove checksum validation in fetcher
• move logic from source to fetcher
• create checksums manager class
• download checksums json during component sync from registry
• improve if parser, support int, bool, string
• support kconfig items as if clause left value
• Use include/exclude file filters with .gitiignore
• Use system TLS certificate store when available (py3.10 or newer)
• add esp32h4 known target
• Remove responsibility for checking version existance when yanking
• Add option to run network tests against the real environment

Fix

• cli: Fix config unset command
• convert component name to lower case
• rename idf_component_tools tests folder
• fix downloading local component
• check if component cache folder exists in overwrite mode
• adjust test to handle breaking change of stdout and stderr behaviour in click 8.2.0
• use env var REGISTRY_URL and PROFILE for deps without registry_url set
• skip calling /api when unnecessary
• Fix hardcoded values to variables
• Skipped asserts in help tests

Refactor

• migrate to ruamel yaml
• improve grammar and clarity in documentation and code comments

https://pypi.org/project/idf-component-manager/2.1.2/

v2.1.2 (2025-01-10)

Fix

• keep comments in config YAML with ruamel.yaml
• Limit urllib3 version for tests
• Always use canonical representation of the component version

v2.1.1 (2024-12-06)

Fix

• Do not expand environment variables when validating example manifests
• Disable caching of task status endpoint

YANKED due "component upload" is not able to return successfully in most cases

v2.1.0 (2024-12-05)

Feat

• cli: add validations for CLI options
• Get all information about Forbidden error from the server
• set local_storage_url as breaking change from 1.x to 2.x
• support compote registry sync --resolution [all,latest]
• Add in-memory cache for API and storage requests
• add debug logging for HTTP requests
• add esp32h21 to known target list
• Add ruamel.yaml dependency
• Improve add-dependency output and help
• Add an option to specify registry url when using add-dependency
• Add git source to add-dependency command
• increase HTTP timeouts, use custom timeout for uploads
• Add support of .gitignore file while uploading / packaging component
• Add use_gitignore option to the manifest
• validate manifest of examples when uploading a component

Fix

• hash value of ComponentRequirement for register_url
• compote registry sync keep same folder structure as the registry
• Fix caching during uploading of components
• default storage url without fetching from registry
• only show debug hints when version solver failed
• unify 1.x 2.x generated parital sync metatdata file
• accept registry_url from api
• Use utf-8 encoding for all text file operations
• recreate lock file when missing env var
• drop current solution if requirement source is different
• ignore local storage urls when generating partial mirror

Refactor

• rewrite partial mirror sync
• use logging module instead of warnings

v2.0.4 (2024-10-01)

Fix

• accept registry_url from api
• increase HTTP timeouts, use custom timeout for uploads
• recreate lock file when missing env var
• drop current solution if requirement source is different
• ignore local storage urls when generating partial mirror
• Use utf-8 encoding for all text file operations

v2.0.3 (2024-08-26)

Fix

• get_storage_client includes component registry_url
• wrong root_managed_components_lock_path
• Fix applying include / exclude lists in GitSource versions method
• Exclude custom dest_dir from component archive

Refactor

• Refactor core.py, change os.path to pathlib.Path

v2.0.2 (2024-08-21)

Fix

• dependency with registry_url unrecognized correctly

v2.0.1 (2024-08-15)

Fix

• Fix filtering of files with default exclude filter patterns
• filterwarning "Running in an environment without IDF" while uploading

v2.0.0 (2024-08-12)

https://pypi.org/project/idf-component-manager/2.0.0/

Some noticeable changes:

• Major refactoring of parsers of idf_component.yml and dependencies.lock files. Error messages are more precise and helpful now.
• Better support for environment variables. You can use conditions in if rules
• Hash sum of the component is checked only when component is downloaded. The old strict behavior can be enabled with IDF_COMPONENT_STRICT_CHECKSUM env variable.
• All environment variables now have prefix IDF_COMPONENT_
• Drop support of python 2.7 and IDF 4.*

Feat

• drop support of root level commit_sha in the manifest file
• Add more descriptive error message for authentication
• compare .component_hash by default, support optionally strict checksum
• Make environment variables in if rules required to have a value
• Revoke token on logout CLI command
• Use compote CLI when executed as module
• support debug mode by setting env var IDF_COMPONENT_MANAGER_DEBUG_MODE
• use current solution while changing target or idf version if it works
• Drop support of Python 2.7
• remove redundant option --namespace from component pack CLI

Fix

• pack and upload components without manifests
• Fix login command with non-existing directory
• union of constraints of unequal clauses
• Wrong version returned by compote version
• Add upload mode to the pack_component
• optional dependencies always skipped when "version" undefined
• skip optional dependencies while solving dependencies
• api response string could be empty
• revert name slug re changes
• correct error message when manifest file is not a dict
• docs: fix render of '--'
• support env var in git source fields git, path
• support env var in local source fields path, override_path
• assume false when exceptions raised in if clause
• reset version solver states when the old solution not working
• test_check_for_newer_component_versions wrong component_hash
• store download_url only in storage client
• cleanup dependencies, lift version restrictions
• Consistent naming convention for ESP Component Registry
• local components in lock file not exist
• re-trigger version solver when optional dependency now meet conditions
• skip the optional dependencies while version solving
• Fix 'default' profile not loading from the config file
• Invalid component name on upload
• Handle missing files/broken symlinks when calculating hash

Refactor

• unify env var with pydantic-settings
• rename service_url to registry_url in manifest files
• remove api cache with file
• remove poetry and do project cleanup
• rewrite with pydantic
• Change comment types to regular ones
• Replace format() with f-strings

Fix

• manifest dump always adds empty fields
• remove redundant option --namespace from component pack CLI
• pack and upload components without manifests
• Fix login command with non-existing directory
• union of constraints of unequal clauses
• Wrong version returned by compote version
• Add upload mode to the pack_component

Feat

• drop support of root level commit_sha in the manifest file

Fix

• pass CLI arguments while uploading packed components
• calculate manifest hash based on set values

Refactor

• remove unused attr component_hash_required

Feat

• Add more descriptive error message for authentication
• compare .component_hash by default, support optionally strict checksum
• Make environment variables in if rules required to have a value
• store images on dockerhub

Fix

• optional dependencies always skipped when "version" undefined
• skip optional dependencies while solving dependencies
• api response string could be empty
• revert name slug re changes
• correct error message when manifest file is not a dict
• docs: fix render of '--'
• support env var in git source fields git, path
• support env var in local source fields path, override_path
• assume false when exceptions raised in if clause

v2.0.0.dev1 (2024-06-19)

https://pypi.org/project/idf-component-manager/2.0.0.dev1/

Feat

• Revoke token on logout CLI command
• Use compote CLI when executed as module
• support debug mode by setting env var IDF_COMPONENT_MANAGER_DEBUG_MODE
• support reuse local existing versions while version solving
• Set COMPONENT_VERSION in CMake from manifests in requirements file
• use current solution while changing target or idf version if it works

Fix

• reset version solver states when the old solution not working
• test_check_for_newer_component_versions wrong component_hash
• store download_url only in storage client
• compote registry login url
• cleanup dependencies, lift version restrictions
• Consistent naming convention for ESP Component Registry
• local components in lock file not exist
• local dep with '__' can be treated as namespace separator correctly
• re-trigger version solver when optional dependency now meet conditions
• skip the optional dependencies while version solving
• Fix 'default' profile not loading from the config file
• Invalid component name on upload

Refactor

• unify env var with pydantic-settings
• rename service_url to registry_url in manifest files
• remove api cache with file
• remove poetry and do project cleanup

v2.0.0-dev0 (2024-05-17)

Feat

• add esp32c61 to the list of known targets
• Drop support of Python 2.7

Fix

• Handle missing files/broken symlinks when calculating hash
• fix the order of managed_components

Refactor

• rewrite with pydantic
• Change comment types to regular ones
• Replace format() with f-strings

v1.5.3 (2024-06-18)

https://pypi.org/project/idf-component-manager/1.5.3/

While a bigger 2.0.0 release is on its way, there are some bug fixes for v1.5

Feat

• support reuse local existing versions while version solving
• Set COMPONENT_VERSION in CMake from manifests in requirements file
• add esp32c61 to the list of known targets

Fix

• use build_name for component while running idf_component_set_property
• compote registry login url
• local dep with '__' can be treated as namespace separator correctly
• fix the order of managed_components
• package schema 0.7.7 supports python 3.6+

v1.5.2 (2024-02-23)

Fix

• wrongly terminate the version solver when versions not been found at the first round
• support boolean type for require field

v1.5.1 (2024-02-14)

Fix

• Handle git compatible version with revision in CLI

https://pypi.org/project/idf-component-manager/1.5.1

v1.5.0 (2024-02-13)

Feat

• add sync command to synchronize local mirror
• used callback to deprecate msg
• add alias for default_namespace and registry_url
• Support overriding components according to the component types
• Included the use of include/exclude filters from the manifest that is used for calculating the component hash.
• Added a user-friendly message to handle a 413 HTTP error triggered by sending large component archive.
• Add esp32c5 target
• Add URL and status code to network error messages
• Added --repository and --commit-sha parameters for packing and uploading component
• Added aliases for '--default_namespace' as '--default-namespace' and '--registry_url' as '--registry-url'. The previous versions have been marked as deprecated.
• Added CLI command compote registry sync to download components and synchronize a local mirror
• Add environment variable to disable TLS verification
• add repository_info block to the manifest
• add commitizen for changelog management

Fix

• optimize import list in .py files, drop unused imports
• fix packing and uploading of the components with lightweight tags
• cli: create test for updated login flags
• Delete log typo
• add missing commitizen config to pyproject.toml
• add missing commitizen config to pyproject.toml
• filter versions when api_client getting versions
• local components should override dependencies with same short name
• move tqdm progress_bar from api_client.py to core.py
• project_components priority should be higher than project_extra_components
• rename component_type to component_source
• Fixed message formatting and progress bar displays during user component upload
• Fixed a problem when the local source created by the override_path parameter doesn't support web_service source keys
• Only expand environment variables in the manifest files during CMake execution
• Manifest dumping with non-expanded environment variables

https://pypi.org/project/idf-component-manager/1.5.0

[1.4.2] - 2024-02-02

Fixed

• Filter yanked versions while getting the list of versions for a component
• Limit "requests-file" version to <2 to avoid incompatibility with older python versions

https://pypi.org/project/idf-component-manager/1.4.2/

[1.4.1] - 2023-10-02

Fixed

• Fix typo in GitLab CI user agent
• Fix issue with creating a profile in idf_component_manager.yml if it does not exist, when executing compote registry login command with --service-profile specified
• Remove warnings of the unknown root keys in the manifest files
• Fix schema validation of idf_component_manager.yml, for an empty profile name value
• Fix manifest schema validation message for an empty field value
• Fix processing of rules and matches for components from the registry
• Fix processing handling of require field for components from the registry

https://pypi.org/project/idf-component-manager/1.4.0/

[1.4.0] - 2023-09-15

Added

• Add CI environment information to the component manager requests user agent
• if-clause supported boolean operator &&, ||, with nested parentheses
• support set version besides if-clause, to override the default dependency version
• support matches for declaring optional dependencies. The first if-clause that matches the condition will be used
• Support license field in the manifest files
• Allow unknown fields in the idf_component_manager.yml config file
• More descriptive manifest validation error messages
• Add default_namespace, registry_url parameters to compote registry login command
• Create a profile in idf_component_manager.yml if it does not exist when executing compote registry login command

Fixed

• Don't require token for --dry-run of compote component upload command
• Fix incorrect message suggestion to check upload status if non-default profile is used
• Add support for non-default registries to compote project create-from-example command through the --service-profile option
• Fix issue with dependencies on local components without a version set
• Skip solving solved component requirements. Speed up version solving
• Support revision in git tags by replacing ~ with . in the version, i.e. 1.0.0.1
• Components under components/ will be treated with higher priority while solving dependencies
• Add component property REQUIRED_IDF_TARGET if the component supports specific targets
• Fixed issue where compote component upload command ignored default_namespace parameter from the profile
• The component manager no longer accesses the API to get the storage URL for the default registry URL

[1.3.2] - 2023-07-05

Fixed

• Keep original if statement in the IfClause object
• Git source dependencies with version field work again

[1.3.1] - 2023-07-03

Fixed

• Fetch the same version as the lock file does while checking solved dependencies

[1.3.0] - 2023-06-30

Changed

• Extend the behavior of compote manifest create and compote manifest add-dependency to create a manifest file based on the context of the current working directory (context of a project or a component)
• Disable API cache by default
• Updated error message if override_path is not a folder

Added

• Add documentation for compote CLI
• Add a check for the existence of a dependency in the registry when using the compote manifest add-dependency command
• Add -W | --warnings-as-errors flag to compote to treat warnings as errors
• Add -p | --path flag to compote manifest create and compote manifest add-dependency to specify the path to the manifest file
• Add compote manifest schema to generate the json schema file of the idf_component.yml
• Add compote cache clear to drop system-wide cache of components and API cache
• Make file cache path configurable via IDF_COMPONENT_CACHE_PATH environment variable
• Add compote cache path command to print the path to the cache directory
• Add compote cache size command to print the size of the cached data
• Add compote version command to print the version of the component manager
• Add IDF_COMPONENT_OVERWRITE_MANAGED_COMPONENTS environment variable to allow overwrite files in the managed_component directory, even if they have been modified by the user
• Add documentation project for the component manager and Espressif component registry
• Treat local source dependency priority higher
• Add --install flag to compote autocomplete to create the completion files and append the sourcing code into the rc files. By default, print the completion functions to the console.
• Add --dry-run flag to compote autocomplete --install to simulate the install script.
• Add --dry-run flag to compote component upload to simulate the upload process
• Print message with the reason why the component manager desided to solve dependencies again
• Add update-dependencies command to idf.py for updating dependencies of the project
• Add manifest format reference to the documentation
• Add compote component yank CLI command to yank version of the component from the registry
• Show warnings from the component registry during uploading components
• Add config for ReadTheDocs
• Add dest-dir option to compote component pack command to specify the destination directory for the archive
• Add compote registry login CLI command to login to the component registry and store the token in the config file

Fixed

• Fix deprecation warnings not showing up in the terminal
• Fix regular expression for repository URL validation
• Stop injecting shell config files by default in compote autocomplete
• Prevent possible DNS spoof when dependencies.lock file exists and no need to be updated.
• Always add idf as a dependency to dependencies.lock file even without explict declaration.
• Fix git submodule update error when using submodule exists in the path field specified in the corresponding git dependency
• Fixed a bug where dependencies of the component weren't updating when local component changed
• Fix mixed slashes in paths on Windows
• Make different error messages for non-existing Version and Component
• Fixed a bug where it was required to set IDF version and target for non-IDF dependent actions
• Fix checks for targets in manifest validator, to make sure newer targets don't cause errors on older ESP-IDF versions

Full Changelog: https://github.com/espressif/idf-component-manager/compare/v1.2.1...v1.3.0

[1.2.3] 2023-05-25

Fixed

• Pin urllib version to <2 to avoid incompatibility with older python versions
• Components with optional dependencies could be uploaded normally
• Relative path in override_path now based on the directory of its idf_component.yml
• Correct spelling of error message for unsatisfied dependency

Fixed

• Fix name and namespace regex used in create project from example command
• Fix compote autocomplete incompatible with click 7.x issue
• Fix compote autocomplete failed when .zshrc has no compinit set
• Fix nondeterministic order of components passed to IDF build system (https://github.com/espressif/esp-idf/issues/10419)
• Fix hash validation for components uploaded with older versions of the component manager

Fixed

• Fix idf.py add-dependency crash for any argument
• Fix regression in python -m idf_component_manager upload-component command

Added

• Add the repository, documentation, issues, and discussion fields for the URLs in the root of the manifest
• Cache request to the API component registry
• Add require field for dependencies. Add possibility to download dependencies without building them.
• Default revision number change from 1 to 0
• Warn users when the override_path point to a non-component directory
• Load component details from pre-rendered JSON files from the static endpoint
• Use local file system like file:// as a Component storage URL
• Record managed component version in component property COMPONENT_VERSION
• Disable API interaction if only storage URL is set
• Add warnings for build files in component version archives
• Add hints for user printed to stderr
• New CLI: compote
• Add create-project-from-example command to the idf.py
• Add the pre_release flag for the dependency to control downloads of pre-release versions
• Print a note with the list of alternative targets when the solver cannot find a suitable component version for the current target but there are some candidates for other targets.
• Add the examples field for the custom examples paths
• Add new environment variables IDF_COMPONENT_REGISTRY_URL and IDF_COMPONENT_REGISTRY_PROFILE for configuring the component manager
• Exclude build artefacts from the examples

Fixed

• Make cache path shorter (important on Windows)
• Set default API responses cache time to 5 minutes
• Fix support of python 3.4
• Hide stack trace after solver dependency error
• Fix packing archives with version from git tag
• Validate case-insensitive duplicate items in the manifest file
• Provide better error message when no network connection
• Improve the error message when failed to solve the dependencies specified in manifest files
• Fix crash on use of local components and override_path for namespaced components
• Mixing stdout and stderr of git command
• Dump manifest file inconsistency with escaped dollar sign
• Fix schema validation of the idf_component_manager.yml config file

Added

• Add the repository, documentation, issues, and discussion fields for the URLs in the root of the manifest
• Cache request to the API component registry
• Add require field for dependencies. Add possibility to download dependencies without building them.
• Default revision number change from 1 to 0
• Warn users when the override_path point to a non-component directory
• Load component details from pre-rendered JSON files from the static endpoint
• Use local file system like file:// as a Component storage URL
• Record managed component version in component property COMPONENT_VERSION
• Disable API interaction if only storage URL is set
• Add warnings for build files in component version archives
• Add hints for user printed to stderr
• New CLI: compote
• Add create-project-from-example command to the idf.py
• Add the pre_release flag for the dependency to control downloads of pre-release versions
• Print a note with the list of alternative targets when the solver cannot find a suitable component version for the current target but there are some candidates for other targets.
• Add the examples field for the custom examples paths
• Add new environment variables IDF_COMPONENT_REGISTRY_URL and IDF_COMPONENT_REGISTRY_PROFILE for configuring the component manager
• Exclude build artefacts from the examples

Fixed

• Hide stack trace after solver dependency error
• Fix packing archives with version from git tag
• Validate case-insensitive duplicate items in the manifest file
• Provide better error message when no network connection
• Improve the error message when failed to solve the dependencies specified in manifest files
• Fix crash on use of local components and override_path for namespaced components
• Mixing stdout and stderr of git command
• Dump manifest file inconsistency with escaped dollar sign
• Fix schema validation of the idf_component_manager.yml config file

Fixed

• Loose the restrictions for pyyaml on python 2.7 and 3.4

Fixed

• error when revision number equals to 1
• colorama version incompatible with python 3.4
• pyyaml version incompatible with python 3.4

Added

• Add constraints for dependencies in setup.py

Fixed

• Fix crash on malformed env variables
• Support revision numbers in version and dependencies -> version