Flower 릴리즈 하기

이 문서는 현재 릴리즈 과정을 설명합니다. 이는 앞으로 변경될 수도 있습니다.

릴리즈 동안에

The version number of a release is stated in ./framework/pyproject.toml. To release a new version of Flower, the following things need to happen (in that order):

  1. Run python3 ./framework/dev/update_changelog.py <YOUR_GH_TOKEN> to add all new changes to the changelog. You can make manual edits to the changelog afterward to improve its formatting or wording. This script will also replace the ## Unreleased header with the new version number and current date, and add a thank-you message for contributors. Open a pull request with these changes.

  2. Once the pull request is merged, tag the release commit with the version number: git tag v<NEW_VERSION> (notice the v added before the version number), then git push --tags. This will create a draft release on GitHub containing the correct artifacts and the relevant part of the changelog.

  3. GitHub에서 릴리즈 초안을 확인하고, 모든 것이 양호하면 게시하세요.

릴리즈 후에

다음 변경 사항이 포함된 pull request를 만듭니다:

  1. Increase the minor version in pyproject.toml by one and update all files which contain the current version number (if necessary) by running ./framework/dev/update_version.py.

  2. Add a new ## Unreleased section at the top of ./framework/docs/source/ref-changelog.md to prepare for future changes.

pull request를 같은 날(즉, 새로운 nightly 릴리즈가 PyPI에 게시되기 전에) 병합하세요.

사전 릴리즈 게시

사전 릴리즈 이름

PyPI는 사전 릴리즈(알파, 베타, 릴리스 후보)를 지원합니다. 사전 릴리즈는 반드시 다음 명명 패턴 중 하나를 사용해야 합니다:

  • Alpha: MAJOR.MINOR.PATCHaN

  • Beta: MAJOR.MINOR.PATCHbN

  • Release candidate (RC): MAJOR.MINOR.PATCHrcN

예시:

  • 1.0.0a0

  • 1.0.0b0

  • 1.0.0rc0

  • 1.0.0rc1

이는 PEP-440 및 Python Packaging Authority (PyPA)의 권장 사항과 일치합니다:

PyPA에서 정의한 접근 방식은 SemVer 2.0.0 사양과 호환되지 않으며, 자세한 내용은`Semantic Versioning 관리 사양 <https://semver.org/spec/v2.0.0.html#spec-item-11>`_ (특히 항목 11이 우선순위)을 참조하세요.

사전 릴리즈 분류

다음 사전 릴리즈를 알파, 베타 또는 릴리스 후보라고 불러야 하나요?

  • RC: 기능 완료, 알려진 문제 없음(다음 stable 릴리즈에서 “수정되지 않음”으로 분류된 문제 제외) - 문제가 나타나지 않으면 다음 stable 릴리즈가 됩니다

  • 베타: 기능 완료, 알려진 문제 발생 가능

  • 알파: 기능 미완성, 알려진 문제가 있을 수 있음