This is a Tianocore maintained project consisting of command line and other python tools and extensions for building and maintaining an Edk2 based UEFI firmware code tree. This package's intent is to provide tools, scripts, and a plugin based environment for use within the tools and scripts. This environment has command line interfaces to support building a product, building CI, running tests, and downloading dependencies. This environment also provides the building blocks for developers to write their own tools to launch in the environment and leverage the capabilities provided by the environment. The unique capabilities provided help support building products with multiple repositories and having each repository contribute/plugin to the build process in a scalable way. The environment will scan the files in the code tree (multiple repos) and discover plugins, dependencies, path adjustments, environment variable settings, etc. This provides easy methods for common repositories to share build tools/steps.
Inclusion of this package is best managed using Pip/Pypi. This package makes use of edk2-pytool-library.
This is a supplemental package and is not required to be used for edk2 builds.
The package contains cli tools and a basic common environment for running tools. This common environment supports extensions, sub-classing, and plugin to allow great flexibility for building and maintaining a code tree.
Examples:
- CI build support with plugin
- Binary dependency resolution (nuget, urls, git repos)
- Loggers (markdown, file, memory, and colored console)
- Plugins (pre/post build, function injection)
- Wrapper around edk2 build
- VarDict and ShellEnvrionment to manage key/value pairs consistently across entire process
- Nuget Publishing tool to push new packages
- Omnicache - Support a super cache of git repos to speed up creating and updating multiple work spaces and minimizing filesystem impact
All content in this repository is licensed under BSD-2-Clause Plus Patent License.
NOTE: It is strongly recommended that you use python virtual environments. Virtual environments avoid changing the global python workspace and causing conflicting dependencies. Virtual environments are lightweight and easy to use. Learn more
-
To install run
pip install --upgrade edk2-pytool-extensions -
To use in your python code
from edk2toolext.<module> import <class>
- Features:
- BREAKING CHANGE - PR 92 - remove special pytool toolchain processing in conf_mgmt
- Bug:
- Issue 90 - edk2_pr_eval policy 3 is not first checking that change is in public file
- Features:
- Add tool to evaluate which packages should be tested for a given PR
- Improved logging and visibility
- Bugs
- Issue 80 - Omnicache path check causes failure when not set
- Features:
- BREAKING CHANGE - PR 77 - Refactor BuildSettingsManager.GetModulePkgsPath to GetPackagesPath
- BREAKING CHANGE - PR 74 - Refactor SetupSettingsManager.GetRequiredRepos to GetRequiredSubmodules and return list of RequiredSubmodule objects
- Bugs
- Issue 65 - web dependency sha256 value is case sensitive
- Issue 72 - Nuget dependencies hang when credentials are needed
- Issue 59 - Missing information from version report
- Features:
- BREAKING CHANGE - PR 48 - Refactor for consistent multi-pkg support in invocables.
- Bugs
- Issue 49 - Build.Conf not parsed correctly
- Issue 47 - Setup, Update, and Build SettingsManager can't optimize based on user supplied CLI options because there is no sharing of that back to settings manager
- Issue 40 - web dependency doesn't work on single files
- Issue 31 - stuart_ci_build should not put all dependency in the PackagesPath
- Issue 23 - Stuart doesn't give a good error when trying to use the wrong invocable
- Issue 15 - Stuart_ci_build -p parameter eats all positional parameters following it
- Features:
- Issue 27 - Add Api to allow override of var_dict entry
- Change CIBuild plugins to allow detection of skipping using newly defined return code
- Bugs
- Issue 27 - When a build variable is updated with same value but different attributes those attributes are not set.
- Bugs
- Issue 14 - XML log created by Stuart_ci_build has incorrect fields
- Bugs
- Issue 14 - XML log created by Stuart_ci_build has incorrect fields
- Bugs
- Issue 11 - MAX_CONCURRENT_THREAD_NUMBER is not required in Target.txt
- Issue 9 - ConfMgmt incorrect usage of shell environment leading to exception
- Features
- Add documentation
- Bugs
- Incorrect import statement in module uefi_build
- clean up EOL and use gitattributes
- Add nuget_publish cli (missing from initial port)
Initial release ported from Project Mu. For history and documentation prior to this see the original Project Mu project https://github.com/microsoft/mu_pip_environment and https://github.com/microsoft/mu_pip_build
| Host Type | Toolchain | Branch | Build Status | Test Status | Code Coverage |
|---|---|---|---|---|---|
| Windows VS 2017 | Python 3.7.x | master |  |
 |
|
| Linux Ubuntu 1604 | Python 3.7.x | master |  |
 |
This project welcomes all types of contributions. For issues, bugs, and questions it is best to open a github issue.
For code contributions this project leverages github pull requests. See github tutorials, help, and documentation for complete descriptions. For best success please follow the below process.
- Contributor opens an issue describing problem or new desired functionality
- Contributor forks repository in github
- Contributor creates branch for work in their fork
- Contributor makes code changes, writes relevant unit tests, authors documentation and release notes as necessary.
- Contributor runs tests locally
- Contributor submits PR to master branch of tianocore/edk2-pytool-extensions
- PR reviewers will provide feedback on change. If any modifications are required, contributor will make changes and push updates.
- PR automation will run and validate tests pass
- If all comments resolved, maintainers approved, and tests pass the PR will be squash merged and closed by the maintainers.
See the github team for more details.
See the github repo docs folder