<h1 align="center">OCE Build</h1>
<p align="center">
<!-- <img
src=""
alt=""
class="center"
width=500px
><br> -->
A minimal framework for fast, secure, and reliable build and dependency management for <a href="https://github.com/acidanthera/OpenCorePkg">OpenCore</a> EFIs.
</p>
<div align="center">
<!-- TODO: Add PyPI badges for supported Python versions, etc -->
<a href="/LICENSE"></a>
<a href="/CHANGELOG.md"></a>
<a href="https://github.com/acidanthera/OpenCorePkg/releases"></a>
<a href="https://github.com/Qonfused/OCE-Build/actions/workflows/ci-python.yml"></a>
</div>
OCE-Build is designed to help enable projects to be highly composable and easily
maintainable, prioritizing a small git-friendly footprint. It is designed to be
flexible and extensible for existing projects, while also providing a simple
configuration and interface for new projects to get started quickly.
## Feature Overview
> **Note**: This project is still in early development and is not yet ready for general use.
The following is a list of features that are planned for the initial release.
- **Declarative Configuration**
- Minimal project configuration.
- Flexible support for any project structure.
- Shared/Template config.plist configurations.
- Automated config.plist schema conflict resolution.
- **Version Management**
- Versioning for OpenCore binaries and resources (Kexts, SSDTs, etc).
- Automatic version resolution for dependencies.
- Lockfile creation for intelligent registry management.
- **Build Support**
- Incremental builds and cache management from lockfile.
- Advanced ACPI language support, including compiler and patchfile options.
- Dependency sorting for proper prelink injection (i.e. SSDTs, Kexts).
- CI support for managing and building Kexts with XCode.
## User Documentation
*This section is for users looking to integrate this tool with their own project.
For information on contributing to this project, refer to the
[Developer Docs](#developer-documentation)*
### Installation
This project is distributed as both a standalone CLI and a Python library on
PyPI. The CLI is intended to be used for simple projects or for CI/CD, while the
library is intended to be used for supporting Python library development or
complex build pipelines. The library also comes bundled with the CLI and it's
source code is available under the `ocebuild.cli` module.
The recommended way to install the CLI is from [GitHub releases](https://github.com/Qonfused/OCE-Build/releases). This will provide you with a standalone executable that can be used without installing Python or any other dependencies. The CLI is available for Windows, macOS, and Linux.
To install the CLI / library from PyPI, you will need to have Python 3.8 or
later installed. You can install Python from [python.org](https://www.python.org/downloads/)
or from your package manager. For more information on installing Python, refer
to the [Python documentation](https://docs.python.org/3/using/index.html).
To install the library directly from PyPI using `pip`, simply run the following
command in your terminal:
```sh
pip install ocebuild
```
Or when using the `poetry` package manager, run:
```sh
poetry add ocebuild
```
Depending on your system, you may need to use `pip3` instead of `pip` when
installing the library. You may also need to use `sudo` or `pip install --user`
to install the library globally or locally, respectively.
After installing the library, the CLI will also be available in your PATH, which
you can invoke by simply running `ocebuild` in your terminal (or `poetry run ocebuild`).
### Getting Started
To get started, you will need to create a `build.yml` file in the root of your
project. This file will contain all of the information needed to build your EFI.
You can follow along with the below example or reference one of the [example projects](https://github.com/Qonfused/OCE-Build/tree/main/examples) included in this repository.
The following is a minimal example of a `build.yml` file located under a `src/`
directory:
```yaml
# src/build.yml
---
build: DEBUG
version: latest
---
ACPI:
Drivers:
- AudioDxe
- HfsPlus
- OpenRuntime
- ResetNvramEntry
Kexts:
Lilu: latest
VirtualSMC: latest
Resources:
Tools:
- OpenShell
```
Once you have created your `build.yml` file, you can run the build command to
build your EFI:
```sh
ocebuild build --cwd src/build.yml
```
This will create a new `dist/` directory in your project containing your EFI.
You can also specify a custom output directory by using the `-o` / `--output`
option. To view all available commands and options, run `ocebuild --help` or run
`ocebuild <command> --help` for more information on a specific command.
Refer to [docs/configuration.md](https://github.com/Qonfused/OCE-Build/blob/main/docs/configuration.md#build-configuration) for more information on how to setup your build
configuration.
Note that this does not output a config.plist file. To generate a config.plist
file, you will need to create a `config.yml` file in the same directory as your
`build.yml` file. The `config.yml` file contains only the changes you wish to
make to the default Sample.plist file (located under `dist/Docs/Sample.plist`).
Refer to [docs/configuration.md](https://github.com/Qonfused/OCE-Build/blob/main/docs/configuration.md#configplist-configuration) for more information.
## Developer Documentation
*This section is for developers looking to contribute to this project. This is
only meant to be a brief overview of the project structure and development
guidelines. For more information, refer to the [contributing](/CONTRIBUTING.md)
documentation.*
### Guidelines and Philosophy
The general philosophy for this project is to keep things as simple as possible.
This means that the project should be easy to understand, easy to maintain, and
easy to contribute to.
A summary of the contributing guidelines for this project are as follows:
- Create an [issue](https://github.com/Qonfused/OCE-Build/issues) for any major
changes and enhancements that you wish to make.
- If you find a security vulnerability, do NOT open an issue. Please refer to our [Security Policy](https://github.com/Qonfused/OCE-Build/security/policy) for reporting security vulnerabilities.
- For questions or discussions related to this project, please open a new GitHub
[discussion](https://github.com/Qonfused/OCE-Build/discussions) instead of
opening an issue.
- Create a [pull request](https://github.com/Qonfused/OCE-Build/pulls) for your
changes and coordinate with the project maintainers to get it merged to main.
- Include unit tests when you contribute new features or fix a bug. This:
- Proves that your code works correctly and prevents regressions from going
unnoticed.
- Guards against breaking changes to the public API and ensures that the
project can remain backwards compatible.
- Lowers the maintenance cost of the project by making it easier to
troubleshoot and debug issues.
- Keep compatibility and cohesiveness mind when contributing a change that
will impact the public API. This helps limit the scope of changes to only
what is required to implement the new feature or fix the bug.
## License
[BSD 3-Clause License](/LICENSE).
Raw data
{
"_id": null,
"home_page": "https://github.com/Qonfused/OCE-Build",
"name": "ocebuild",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "cli,tui,packaging,dependency,opencore",
"author": "Cory Bennett",
"author_email": "csquaredbennett@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d6/d2/6eb6066cf95983021c73beca97002ca498e79da98948f0128c1e150072e3/ocebuild-0.0.0.dev0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">OCE Build</h1>\n<p align=\"center\">\n <!-- <img\n src=\"\"\n alt=\"\"\n class=\"center\"\n width=500px\n ><br> -->\n A minimal framework for fast, secure, and reliable build and dependency management for <a href=\"https://github.com/acidanthera/OpenCorePkg\">OpenCore</a> EFIs.\n</p>\n\n<div align=\"center\">\n\n <!-- TODO: Add PyPI badges for supported Python versions, etc -->\n <a href=\"/LICENSE\"></a>\n <a href=\"/CHANGELOG.md\"></a>\n <a href=\"https://github.com/acidanthera/OpenCorePkg/releases\"></a>\n <a href=\"https://github.com/Qonfused/OCE-Build/actions/workflows/ci-python.yml\"></a>\n\n</div>\n\nOCE-Build is designed to help enable projects to be highly composable and easily\nmaintainable, prioritizing a small git-friendly footprint. It is designed to be\nflexible and extensible for existing projects, while also providing a simple\nconfiguration and interface for new projects to get started quickly.\n\n## Feature Overview\n\n> **Note**: This project is still in early development and is not yet ready for general use.\nThe following is a list of features that are planned for the initial release.\n\n- **Declarative Configuration**\n - Minimal project configuration.\n - Flexible support for any project structure.\n - Shared/Template config.plist configurations.\n - Automated config.plist schema conflict resolution.\n- **Version Management**\n - Versioning for OpenCore binaries and resources (Kexts, SSDTs, etc).\n - Automatic version resolution for dependencies.\n - Lockfile creation for intelligent registry management.\n- **Build Support**\n - Incremental builds and cache management from lockfile.\n - Advanced ACPI language support, including compiler and patchfile options.\n - Dependency sorting for proper prelink injection (i.e. SSDTs, Kexts).\n - CI support for managing and building Kexts with XCode.\n\n## User Documentation\n\n*This section is for users looking to integrate this tool with their own project.\nFor information on contributing to this project, refer to the\n[Developer Docs](#developer-documentation)*\n\n### Installation\n\nThis project is distributed as both a standalone CLI and a Python library on\nPyPI. The CLI is intended to be used for simple projects or for CI/CD, while the\nlibrary is intended to be used for supporting Python library development or\ncomplex build pipelines. The library also comes bundled with the CLI and it's\nsource code is available under the `ocebuild.cli` module.\n\nThe recommended way to install the CLI is from [GitHub releases](https://github.com/Qonfused/OCE-Build/releases). This will provide you with a standalone executable that can be used without installing Python or any other dependencies. The CLI is available for Windows, macOS, and Linux.\n\nTo install the CLI / library from PyPI, you will need to have Python 3.8 or\nlater installed. You can install Python from [python.org](https://www.python.org/downloads/)\nor from your package manager. For more information on installing Python, refer\nto the [Python documentation](https://docs.python.org/3/using/index.html).\n\nTo install the library directly from PyPI using `pip`, simply run the following\ncommand in your terminal:\n```sh\npip install ocebuild\n```\n\nOr when using the `poetry` package manager, run:\n```sh\npoetry add ocebuild\n```\n\nDepending on your system, you may need to use `pip3` instead of `pip` when\ninstalling the library. You may also need to use `sudo` or `pip install --user`\nto install the library globally or locally, respectively.\n\nAfter installing the library, the CLI will also be available in your PATH, which\nyou can invoke by simply running `ocebuild` in your terminal (or `poetry run ocebuild`).\n\n### Getting Started\n\nTo get started, you will need to create a `build.yml` file in the root of your\nproject. This file will contain all of the information needed to build your EFI.\nYou can follow along with the below example or reference one of the [example projects](https://github.com/Qonfused/OCE-Build/tree/main/examples) included in this repository.\n\nThe following is a minimal example of a `build.yml` file located under a `src/`\ndirectory:\n\n```yaml\n# src/build.yml\n---\nbuild: DEBUG\nversion: latest\n---\nACPI:\nDrivers:\n - AudioDxe\n - HfsPlus\n - OpenRuntime\n - ResetNvramEntry\nKexts:\n Lilu: latest\n VirtualSMC: latest\nResources:\nTools:\n - OpenShell\n```\n\nOnce you have created your `build.yml` file, you can run the build command to\nbuild your EFI:\n\n```sh\nocebuild build --cwd src/build.yml\n```\n\nThis will create a new `dist/` directory in your project containing your EFI.\nYou can also specify a custom output directory by using the `-o` / `--output`\noption. To view all available commands and options, run `ocebuild --help` or run\n`ocebuild <command> --help` for more information on a specific command.\n\nRefer to [docs/configuration.md](https://github.com/Qonfused/OCE-Build/blob/main/docs/configuration.md#build-configuration) for more information on how to setup your build\nconfiguration.\n\nNote that this does not output a config.plist file. To generate a config.plist\nfile, you will need to create a `config.yml` file in the same directory as your\n`build.yml` file. The `config.yml` file contains only the changes you wish to\nmake to the default Sample.plist file (located under `dist/Docs/Sample.plist`).\nRefer to [docs/configuration.md](https://github.com/Qonfused/OCE-Build/blob/main/docs/configuration.md#configplist-configuration) for more information.\n\n## Developer Documentation\n\n*This section is for developers looking to contribute to this project. This is\nonly meant to be a brief overview of the project structure and development\nguidelines. For more information, refer to the [contributing](/CONTRIBUTING.md)\ndocumentation.*\n\n### Guidelines and Philosophy\n\nThe general philosophy for this project is to keep things as simple as possible.\nThis means that the project should be easy to understand, easy to maintain, and\neasy to contribute to.\n\nA summary of the contributing guidelines for this project are as follows:\n\n- Create an [issue](https://github.com/Qonfused/OCE-Build/issues) for any major\n changes and enhancements that you wish to make.\n - If you find a security vulnerability, do NOT open an issue. Please refer to our [Security Policy](https://github.com/Qonfused/OCE-Build/security/policy) for reporting security vulnerabilities.\n - For questions or discussions related to this project, please open a new GitHub\n [discussion](https://github.com/Qonfused/OCE-Build/discussions) instead of\n opening an issue.\n- Create a [pull request](https://github.com/Qonfused/OCE-Build/pulls) for your\n changes and coordinate with the project maintainers to get it merged to main.\n - Include unit tests when you contribute new features or fix a bug. This:\n - Proves that your code works correctly and prevents regressions from going\n unnoticed.\n - Guards against breaking changes to the public API and ensures that the\n project can remain backwards compatible.\n - Lowers the maintenance cost of the project by making it easier to\n troubleshoot and debug issues.\n - Keep compatibility and cohesiveness mind when contributing a change that\n will impact the public API. This helps limit the scope of changes to only\n what is required to implement the new feature or fix the bug.\n\n## License\n\n[BSD 3-Clause License](/LICENSE).\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Portable OpenCore EFI dependency & build manager.",
"version": "0.0.0.dev0",
"project_urls": {
"Documentation": "https://ocebuild.readthedocs.io/",
"Homepage": "https://github.com/Qonfused/OCE-Build",
"Repository": "https://github.com/Qonfused/OCE-Build"
},
"split_keywords": [
"cli",
"tui",
"packaging",
"dependency",
"opencore"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f09e0d9282a982fbc34a828d5b338556a484d645f16ce208f0e3206244cdc310",
"md5": "18afc0751a07b5984334ad7391bbe9c7",
"sha256": "b8d10a6f03dca680374ef5d1993730fa51b2195d4efe55a41e07a733418cf6d5"
},
"downloads": -1,
"filename": "ocebuild-0.0.0.dev0-cp312-cp312-macosx_13_0_x86_64.whl",
"has_sig": false,
"md5_digest": "18afc0751a07b5984334ad7391bbe9c7",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8",
"size": 166736,
"upload_time": "2023-08-09T00:55:13",
"upload_time_iso_8601": "2023-08-09T00:55:13.212600Z",
"url": "https://files.pythonhosted.org/packages/f0/9e/0d9282a982fbc34a828d5b338556a484d645f16ce208f0e3206244cdc310/ocebuild-0.0.0.dev0-cp312-cp312-macosx_13_0_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d6d26eb6066cf95983021c73beca97002ca498e79da98948f0128c1e150072e3",
"md5": "30eb78a4d0885a4e71304829cc99f1a2",
"sha256": "fc6c07bc75aaaa24bf1bf325db6abe14b3ac1c8ba63551f5415e8c058413df11"
},
"downloads": -1,
"filename": "ocebuild-0.0.0.dev0.tar.gz",
"has_sig": false,
"md5_digest": "30eb78a4d0885a4e71304829cc99f1a2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 83344,
"upload_time": "2023-08-09T00:55:15",
"upload_time_iso_8601": "2023-08-09T00:55:15.023547Z",
"url": "https://files.pythonhosted.org/packages/d6/d2/6eb6066cf95983021c73beca97002ca498e79da98948f0128c1e150072e3/ocebuild-0.0.0.dev0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-09 00:55:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Qonfused",
"github_project": "OCE-Build",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ocebuild"
}
JSON
