Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🚸 Make reusable workflows more generic #407

Merged
merged 40 commits into from
Aug 28, 2023

Conversation

burgholzer
Copy link
Member

@burgholzer burgholzer commented Aug 23, 2023

Description

This PR tries to make the reusable workflows from the repository truly reusable in our top-level projects; at least in the top-priority ones. This includes:

  • passing additional CMake arguments to the configure calls
  • potentially setting up Z3
  • running mypy in GitHub CI instead of pre-commit.ci (frequently runs out of memory if you add to many dependencies to the mypy job)
  • eliminates the need for a CodeQL configuration file
  • adding retry jobs on coverage uploads
  • a minimal versions Python test with coverage that makes sure everything works with all the lower caps
  • automatically setting the DEPLOY CMake variable in CI systems

Checklist:

  • The pull request only contains commits that are related to it.
  • I have added appropriate tests and documentation.
  • I have made sure that all CI jobs on GitHub pass.
  • The pull request introduces no new warnings and follows the project's style guidelines.

Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
this allows to, e.g., set the toolchain on Windows systems, or enable extra flags to include tests, etc.

Signed-off-by: burgholzer <burgholzer@me.com>
Z3 is used in some of our project, and the reusable workflows should also be applicable there.

Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
@burgholzer burgholzer added github_actions Pull requests that update Github_actions code usability Anything related to usability continuous integration Anything related to the CI setup labels Aug 23, 2023
@burgholzer burgholzer added this to the MQT Core milestone Aug 23, 2023
@burgholzer burgholzer self-assigned this Aug 23, 2023
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
Signed-off-by: burgholzer <burgholzer@me.com>
@burgholzer burgholzer merged commit 226315a into main Aug 28, 2023
32 checks passed
@burgholzer burgholzer deleted the make-reusable-workflows-more-generic branch August 28, 2023 10:12
burgholzer added a commit to cda-tum/mqt-qcec that referenced this pull request Aug 28, 2023
## Description

This PR brings a major refactoring for the overall Python packaging as
well as the CI employed in the project.

### Packaging

We are (finally) moving away from `setuptools` and towards modern
`scikit-build-core` (https://scikit-build-core.readthedocs.io/)
This brings many advantages such as 
- truly editable installs that also include the C++ part; this implies
incredibly fast rebuilds that can be further improved by installing
ccache.
- completely eliminates the `setup.py` (and the `MANIFEST.in`) file and
all custom build code that was required previously.

As part of this change, we adopt the established best practice of a
src-layout for the Python package. This implies that the Python package
no longer lives in the main package directory, but is moved to
`src/mqt/...`.
This avoids several pitfalls when working with Python packages and makes
the overall handling way easier.

This also means there is no direct build-time dependency on cmake and
ninja anymore as this is automatically handled by scikit-build-core on
demand.

As part of this rewrite, several `nox` sessions are also updated

### CI

MQT Core has introduced reusable workflows in 
- cda-tum/mqt-core#396

These have been further refined in 
- cda-tum/mqt-core#407

Overall, this allows to 
- remove almost all workflow files of this repository
- eliminate a lot of maintenance required in this repository to keep up
with the latest best practices
- rely on dependabot for workflow updates once MQT Core has settled
enough so that it follows proper versioning and we can use tags for the
workflows here instead of `@main`

while at the same time:
- having automatic change detection and only triggering jobs that are
really necessary; with a single pass check that can be used for branch
protection
- setting up ccache for all supported workflow jobs which greatly
improves compilation times
- setting up mold as a better linker under linux
- splitting jobs into as many subjobs as possible and feasible to
distribute work
- automatically creating wheels for all supported platforms (including
exotic platforms that need emulation) and Python versions using PyPI
trusted publishing
- enabling automatic retries for flaky jobs such as MSVC builds or
coverage uploads
- enabling automatic build parallelization via using Ninja wherever
suitable
- running an automatic workflow using the minimal versiosn for all
Python dependencies to guarantee compatibility

As a nice side effect, the new CI runs have revealed a bug in the
permutation handling of the ZX checker that has subsequently been
resolved.

## Checklist:

<!---
This checklist serves as a reminder of a couple of things that ensure
your pull request will be merged swiftly.
-->

- [x] The pull request only contains commits that are related to it.
- [x] I have added appropriate tests and documentation.
- [x] I have made sure that all CI jobs on GitHub pass.
- [x] The pull request introduces no new warnings and follows the
project's style guidelines.
burgholzer added a commit to cda-tum/mqt-qmap that referenced this pull request Aug 28, 2023
## Description

This PR brings a major refactoring for the overall Python packaging as
well as the CI employed in the project.

### Packaging

We are (finally) moving away from `setuptools` and towards modern
`scikit-build-core` (https://scikit-build-core.readthedocs.io/)
This brings many advantages such as 
- truly editable installs that also include the C++ part; this implies
incredibly fast rebuilds that can be further improved by installing
ccache.
- completely eliminates the `setup.py` (and the `MANIFEST.in`) file and
all custom build code that was required previously.

As part of this change, we adopt the established best practice of a
src-layout for the Python package. This implies that the Python package
no longer lives in the main package directory, but is moved to
`src/mqt/...`.
This avoids several pitfalls when working with Python packages and makes
the overall handling way easier.

This also means there is no direct build-time dependency on cmake and
ninja anymore as this is automatically handled by scikit-build-core on
demand.

As part of this rewrite, several `nox` sessions are also updated

### CI

MQT Core has introduced reusable workflows in 
- cda-tum/mqt-core#396

These have been further refined in 
- cda-tum/mqt-core#407

Overall, this allows to 
- remove almost all workflow files of this repository
- eliminate a lot of maintenance required in this repository to keep up
with the latest best practices
- rely on dependabot for workflow updates once MQT Core has settled
enough so that it follows proper versioning and we can use tags for the
workflows here instead of `@main`

while at the same time:
- having automatic change detection and only triggering jobs that are
really necessary; with a single pass check that can be used for branch
protection
- setting up ccache for all supported workflow jobs which greatly
improves compilation times
- setting up mold as a better linker under linux
- splitting jobs into as many subjobs as possible and feasible to
distribute work
- automatically creating wheels for all supported platforms (including
exotic platforms that need emulation) and Python versions using PyPI
trusted publishing
- enabling automatic retries for flaky jobs such as MSVC builds or
coverage uploads
- enabling automatic build parallelization via using Ninja wherever
suitable
- running an automatic workflow using the minimal versiosn for all
Python dependencies to guarantee compatibility

As a nice side effect, the new CI has revealed two bugs in the heuristic
mapper. One where the single-qubit gates could not be placed properly
and one where the output permutation inference accessed arrays out of
bounds. Both issues have subsequently been fixed.

## Checklist:

<!---
This checklist serves as a reminder of a couple of things that ensure
your pull request will be merged swiftly.
-->

- [x] The pull request only contains commits that are related to it.
- [x] I have added appropriate tests and documentation.
- [x] I have made sure that all CI jobs on GitHub pass.
- [x] The pull request introduces no new warnings and follows the
project's style guidelines.
burgholzer added a commit to cda-tum/mqt-ddsim that referenced this pull request Aug 28, 2023
## Description

This PR brings a major refactoring for the overall Python packaging as
well as the CI employed in the project.

### Packaging

We are (finally) moving away from `setuptools` and towards modern
`scikit-build-core` (https://scikit-build-core.readthedocs.io/)
This brings many advantages such as 
- truly editable installs that also include the C++ part; this implies
incredibly fast rebuilds that can be further improved by installing
ccache.
- completely eliminates the `setup.py` (and the `MANIFEST.in`) file and
all custom build code that was required previously.

As part of this change, we adopt the established best practice of a
src-layout for the Python package. This implies that the Python package
no longer lives in the main package directory, but is moved to
`src/mqt/...`.
This avoids several pitfalls when working with Python packages and makes
the overall handling way easier.

This also means there is no direct build-time dependency on cmake and
ninja anymore as this is automatically handled by scikit-build-core on
demand.

As part of this rewrite, several `nox` sessions are also updated

### CI

MQT Core has introduced reusable workflows in 
- cda-tum/mqt-core#396

These have been further refined in 
- cda-tum/mqt-core#407

Overall, this allows to 
- remove almost all workflow files of this repository
- eliminate a lot of maintenance required in this repository to keep up
with the latest best practices
- rely on dependabot for workflow updates once MQT Core has settled
enough so that it follows proper versioning and we can use tags for the
workflows here instead of `@main`

while at the same time:
- having automatic change detection and only triggering jobs that are
really necessary; with a single pass check that can be used for branch
protection
- setting up ccache for all supported workflow jobs which greatly
improves compilation times
- setting up mold as a better linker under linux
- splitting jobs into as many subjobs as possible and feasible to
distribute work
- automatically creating wheels for all supported platforms (including
exotic platforms that need emulation) and Python versions using PyPI
trusted publishing
- enabling automatic retries for flaky jobs such as MSVC builds or
coverage uploads
- enabling automatic build parallelization via using Ninja wherever
suitable
- running an automatic workflow using the minimal versiosn for all
Python dependencies to guarantee compatibility

As a nice side effect, the new CI has unveiled several issues in the HSF
simulator and it's task logic that have subsequently been resolved. Upon
writing regression tests, an endianness bug in the Amplitude Mode HSF
simulation surfaced. With this PR, the expected results are returned.

## Checklist:

<!---
This checklist serves as a reminder of a couple of things that ensure
your pull request will be merged swiftly.
-->

- [x] The pull request only contains commits that are related to it.
- [x] I have added appropriate tests and documentation.
- [x] I have made sure that all CI jobs on GitHub pass.
- [x] The pull request introduces no new warnings and follows the
project's style guidelines.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
continuous integration Anything related to the CI setup github_actions Pull requests that update Github_actions code usability Anything related to usability
Projects
Status: Done
Status: Done
Development

Successfully merging this pull request may close these issues.

1 participant