arno
/
trezor-firmware
mirror of https://github.com/trezor/trezor-firmware.git
1
0
Fork 0
Code Issues Releases Wiki Activity

docs(core+legacy): use towncrier for generating CHANGELOG.md

Browse Source 
core/embed/boardloader/CHANGELOG.md
core/embed/bootloader/CHANGELOG.md
core/embed/bootloader_ci/CHANGELOG.md
legacy/intermediate_fw/CHANGELOG.md
pull/1581/head
Martin Milata 3 years ago committed by matejcik
parent d35071d732
commit 412d06fdfe
24 changed files with 41 additions and 61 deletions
Show Stats Download Patch File Download Diff File

8
Makefile
Unescape View File

@ -41,9 +41,13 @@ pystyle: ## apply code style on application sources and tests
changelog_check: ## check changelog format changelog_check: ## check changelog format
./tools/generate-changelog.py --check core ./tools/generate-changelog.py --check core
./tools/generate-changelog.py --check python ./tools/generate-changelog.py --check core/embed/boardloader
./tools/generate-changelog.py --check legacy/firmware ./tools/generate-changelog.py --check core/embed/bootloader
./tools/generate-changelog.py --check core/embed/bootloader_ci
./tools/generate-changelog.py --check legacy/bootloader ./tools/generate-changelog.py --check legacy/bootloader
./tools/generate-changelog.py --check legacy/firmware
./tools/generate-changelog.py --check legacy/intermediate_fw
./tools/generate-changelog.py --check python
yaml_check: ## check yaml formatting yaml_check: ## check yaml formatting
yamllint . yamllint .

2
ci/check_changelog.sh
Unescape View File

@ -2,7 +2,7 @@
base_branch=master base_branch=master
fail=0 fail=0
subdirs="core python legacy/firmware legacy/bootloader" subdirs="core core/embed/boardloader core/embed/bootloader core/embed/bootloader_ci legacy/bootloader legacy/firmware legacy/intermediate_fw python"
changed_files=$(mktemp) changed_files=$(mktemp)
trap 'rm -- $changed_files' EXIT trap 'rm -- $changed_files' EXIT

1
core/embed/boardloader/.changelog.d/.gitignore vendored
Unescape View File

@ -0,0 +1 @@
!.gitignore

1
core/embed/boardloader/.towncrier.template.md
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.template.md

12
core/embed/boardloader/CHANGELOG.md
Unescape View File

@ -4,15 +4,3 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
### Added
### Deprecated
### Removed
### Fixed
### Security

1
core/embed/boardloader/CHANGELOG.unreleased
Unescape View File

@ -0,0 +1 @@
../../../tools/generate-changelog-unreleased.sh

1
core/embed/boardloader/towncrier.toml
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.toml

1
core/embed/bootloader/.changelog.d/.gitignore vendored
Unescape View File

@ -0,0 +1 @@
!.gitignore

1
core/embed/bootloader/.towncrier.template.md
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.template.md

20
core/embed/bootloader/CHANGELOG.md
Unescape View File

@ -4,33 +4,19 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
### Added ## 2.0.3 [March 2019]
### Deprecated
### Removed
### Fixed
### Security
------------
## 2.0.3 [Mar 2019]
### Security ### Security
- Enable MPU - Enable MPU
- Introduce delays to USB stack - Introduce delays to USB stack
## 2.0.2 [Dec 2018] ## 2.0.2 [December 2018]
### Added ### Added
- Support for a new display driver - Support for a new display driver
## 2.0.1 [Feb 2018] ## 2.0.1 [February 2018]
### Added ### Added
- First public release - First public release

1
core/embed/bootloader/CHANGELOG.unreleased
Unescape View File

@ -0,0 +1 @@
../../../tools/generate-changelog-unreleased.sh

1
core/embed/bootloader/towncrier.toml
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.toml

1
core/embed/bootloader_ci/.changelog.d/.gitignore vendored
Unescape View File

@ -0,0 +1 @@
!.gitignore

1
core/embed/bootloader_ci/.towncrier.template.md
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.template.md

15
core/embed/bootloader_ci/CHANGELOG.md
Unescape View File

@ -4,19 +4,8 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
### Added ## 1.0.1 [January 2021]
### Deprecated
### Removed
### Fixed
### Security
## 1.0.1 [Jan 2021]
### Added ### Added
- Decouple files from original bootloader as it will be reworked and symlink - Decouple files from original bootloader as it will be reworked and symlink
@ -24,7 +13,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
- Version in version.h must be kept to match the original bootloader, - Version in version.h must be kept to match the original bootloader,
otherwise firmware update will fail (bootloader will look too old) otherwise firmware update will fail (bootloader will look too old)
## 1.0.0 [Aug 2020] ## 1.0.0 [August 2020]
### Added ### Added
- Initial version - Initial version

1
core/embed/bootloader_ci/CHANGELOG.unreleased
Unescape View File

@ -0,0 +1 @@
../../../tools/generate-changelog-unreleased.sh

1
core/embed/bootloader_ci/towncrier.toml
Unescape View File

@ -0,0 +1 @@
../../../tools/towncrier.toml

6
docs/misc/changelog.md
Unescape View File

@ -3,12 +3,16 @@
Our releases are accompanied by changelogs based on the Our releases are accompanied by changelogs based on the
[Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format. We are using [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format. We are using
the [towncrier](https://github.com/twisted/towncrier) utility to generate them the [towncrier](https://github.com/twisted/towncrier) utility to generate them
at the time a new version is released. There are currently four such changelogs at the time a new version is released. There are currently 8 such changelogs
for different components of the repository: for different components of the repository:
* **[`core/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/core/CHANGELOG.md)** for Trezor T firmware * **[`core/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/core/CHANGELOG.md)** for Trezor T firmware
* **[`core/embed/boardloader/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/core/embed/boardloader/CHANGELOG.md)** for Trezor T boardloader
* **[`core/embed/bootloader/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/core/embed/bootloader/CHANGELOG.md)** for Trezor T bootloader
* **[`core/embed/bootloader_ci/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/core/embed/bootloader_ci/CHANGELOG.md)** for Trezor T CI bootloader
* **[`legacy/firmware/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/legacy/firmware/CHANGELOG.md)** for Trezor 1 firmware * **[`legacy/firmware/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/legacy/firmware/CHANGELOG.md)** for Trezor 1 firmware
* **[`legacy/bootloader/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/legacy/bootloader/CHANGELOG.md)** for Trezor 1 bootloader * **[`legacy/bootloader/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/legacy/bootloader/CHANGELOG.md)** for Trezor 1 bootloader
* **[`legacy/intermediate_fw/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/legacy/intermediate_fw/CHANGELOG.md)** for Trezor 1 intermediate firmware
* **[`python/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/python/CHANGELOG.md)** for Python client library * **[`python/CHANGELOG.md`](https://github.com/trezor/trezor-firmware/blob/master/python/CHANGELOG.md)** for Python client library
## Adding changelog entry ## Adding changelog entry

1
legacy/intermediate_fw/.changelog.d/.gitignore vendored
Unescape View File

@ -0,0 +1 @@
!.gitignore

1
legacy/intermediate_fw/.towncrier.template.md
Unescape View File

@ -0,0 +1 @@
../../tools/towncrier.template.md

16
legacy/intermediate_fw/CHANGELOG.md
Unescape View File

@ -4,24 +4,12 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased] ## 1.9.0 [February 2021]
### Added
### Deprecated
### Removed
### Fixed
### Security
## 1.9.0 [Feb 2021]
### Added ### Added
- Update bootloader to 1.9.0 - Update bootloader to 1.9.0
## 1.8.0 [Jun 2021] ## 1.8.0 [June 2021]
### Added ### Added
- Initial version of intermediate firmware - Initial version of intermediate firmware

1
legacy/intermediate_fw/CHANGELOG.unreleased
Unescape View File

@ -0,0 +1 @@
../../tools/generate-changelog-unreleased.sh

1
legacy/intermediate_fw/towncrier.toml
Unescape View File

@ -0,0 +1 @@
../../tools/towncrier.toml

7
tools/generate-changelog.py
Unescape View File

@ -79,7 +79,12 @@ def current_date(project):
parts = project.parts parts = project.parts
today = datetime.datetime.now() today = datetime.datetime.now()
if parts[-2:] == ("legacy", "bootloader"): if (
parts[-3:] == ("core", "embed", "bootloader")
or parts[-3:] == ("core", "embed", "bootloader_ci")
or parts[-2:] == ("legacy", "bootloader")
or parts[-2:] == ("legacy", "intermediate_fw")
):
return today.strftime("%B %Y") return today.strftime("%B %Y")
elif parts[-1] == "python": elif parts[-1] == "python":
return today.strftime("%Y-%m-%d") return today.strftime("%Y-%m-%d")

Write Preview
Loading…
Cancel
Save