mirror of
https://github.com/ratatui-org/ratatui
synced 2024-09-19 22:22:01 +00:00
chore(release): prepare for 0.28.1 (#1343)
🧀 The current release steps in reference to #1337 - Bump version in `Cargo.toml` - `git cliff -u -p CHANGELOG.md -t v0.28.1` - Merge the PR - `git tag v0.28.1` - `git push origin v0.28.1` We can probably automate away most of these with `release-plz` when it fully supports `git-cliff`'s GitHub integration.
This commit is contained in:
Orhun Parmaksız
GitHub
parent
65da535745
commit
3a90e2a761
2 changed files with 178 additions and 1 deletions
177
CHANGELOG.md
177
CHANGELOG.md
|
|
@ -2,6 +2,183 @@
|
|||
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
## [v0.28.1](https://github.com/ratatui/ratatui/releases/tag/v0.28.1) - 2024-08-25
|
||||
|
||||
### Features
|
||||
|
||||
- [ed51c4b](https://github.com/ratatui/ratatui/commit/ed51c4b3429862201b2c5de6846fea4c237f0ffb) *(terminal)* Add ratatui::init() and restore() methods by @joshka in [#1289](https://github.com/ratatui/ratatui/pull/1289)
|
||||
|
||||
> These are simple opinionated methods for creating a terminal that is
|
||||
> useful to use in most apps. The new init method creates a crossterm
|
||||
> backend writing to stdout, enables raw mode, enters the alternate
|
||||
> screen, and sets a panic handler that restores the terminal on panic.
|
||||
>
|
||||
> A minimal hello world now looks a bit like:
|
||||
>
|
||||
> ```rust
|
||||
> use ratatui::{
|
||||
> crossterm::event::{self, Event},
|
||||
> text::Text,
|
||||
> Frame,
|
||||
> };
|
||||
>
|
||||
> fn main() {
|
||||
> let mut terminal = ratatui::init();
|
||||
> loop {
|
||||
> terminal
|
||||
> .draw(|frame: &mut Frame| frame.render_widget(Text::raw("Hello World!"), frame.area()))
|
||||
> .expect("Failed to draw");
|
||||
> if matches!(event::read().expect("failed to read event"), Event::Key(_)) {
|
||||
> break;
|
||||
> }
|
||||
> }
|
||||
> ratatui::restore();
|
||||
> }
|
||||
> ```
|
||||
>
|
||||
> A type alias `DefaultTerminal` is added to represent this terminal
|
||||
> type and to simplify any cases where applications need to pass this
|
||||
> terminal around. It is equivalent to:
|
||||
> `Terminal<CrosstermBackend<Stdout>>`
|
||||
>
|
||||
> We also added `ratatui::try_init()` and `try_restore()`, for situations
|
||||
> where you might want to handle initialization errors yourself instead
|
||||
> of letting the panic handler fire and cleanup. Simple Apps should
|
||||
> prefer the `init` and `restore` functions over these functions.
|
||||
>
|
||||
> Corresponding functions to allow passing a `TerminalOptions` with
|
||||
> a `Viewport` (e.g. inline, fixed) are also available
|
||||
> (`init_with_options`,
|
||||
> and `try_init_with_options`).
|
||||
>
|
||||
> The existing code to create a backend and terminal will remain and
|
||||
> is not deprecated by this approach. This just provides a simple one
|
||||
> line initialization using the common options.
|
||||
>
|
||||
> ---------
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
- [aed60b9](https://github.com/ratatui/ratatui/commit/aed60b98394edc834d9fe8e96c3698510b5922f4) *(terminal)* Terminal::insert_before would crash when called while the viewport filled the screen by @nfachan in [#1329](https://github.com/ratatui/ratatui/pull/1329)
|
||||
|
||||
> Reimplement Terminal::insert_before. The previous implementation would
|
||||
> insert the new lines in chunks into the area between the top of the
|
||||
> screen and the top of the (new) viewport. If the viewport filled the
|
||||
> screen, there would be no area in which to insert lines, and the
|
||||
> function would crash.
|
||||
>
|
||||
> The new implementation uses as much of the screen as it needs to, all
|
||||
> the way up to using the whole screen.
|
||||
>
|
||||
> This commit:
|
||||
> - adds a scrollback buffer to the `TestBackend` so that tests can
|
||||
> inspect and assert the state of the scrollback buffer in addition to the
|
||||
> screen
|
||||
> - adds functions to `TestBackend` to assert the state of the scrollback
|
||||
> - adds and updates `TestBackend` tests to test the behavior of the
|
||||
> scrollback and the new asserting functions
|
||||
> - reimplements `Terminal::insert_before`, including adding two new
|
||||
> helper functions `Terminal::draw_lines` and `Terminal::scroll_up`.
|
||||
> - updates the documentation for `Terminal::insert_before` to clarify
|
||||
> some of the edge cases
|
||||
> - updates terminal tests to assert the state of the scrollback buffer
|
||||
> - adds a new test for the condition that causes the bug
|
||||
> - adds a conversion constructor `Cell::from(char)`
|
||||
>
|
||||
> Fixes:https://github.com/ratatui/ratatui/issues/999
|
||||
|
||||
- [fdd5d8c](https://github.com/ratatui/ratatui/commit/fdd5d8c092b33c188b0657f5a2e17fa6712a91ae) *(text)* Remove trailing newline from single-line Display trait impl by @LucasPickering in [#1320](https://github.com/ratatui/ratatui/pull/1320)
|
||||
|
||||
- [2fb0b8a](https://github.com/ratatui/ratatui/commit/2fb0b8a741e7e20d4bbef8077e25d63e5ee51d83) *(uncategorized)* Fix u16 overflow in Terminal::insert_before. by @nfachan in [#1323](https://github.com/ratatui/ratatui/pull/1323)
|
||||
|
||||
> If the amount of characters in the screen above the viewport was greater
|
||||
> than u16::MAX, a multiplication would overflow. The multiply was used to
|
||||
> compute the maximum chunk size. The fix is to just do the multiplication
|
||||
> as a usize and also do the subsequent division as a usize.
|
||||
>
|
||||
> There is currently another outstanding issue that limits the amount of
|
||||
> characters that can be inserted when calling Terminal::insert_before to
|
||||
> u16::MAX. However, this bug can still occur even if the viewport and the
|
||||
> amount of characters being inserted are both less than u16::MAX, since
|
||||
> it's dependant on how large the screen is above the viewport.
|
||||
>
|
||||
> Fixes #1322
|
||||
|
||||
### Documentation
|
||||
|
||||
- [3631b34](https://github.com/ratatui/ratatui/commit/3631b34f538a14840d633de57a0beb59c83bd649) *(examples)* Add widget implementation example by @joshka in [#1147](https://github.com/ratatui/ratatui/pull/1147)
|
||||
|
||||
> This new example documents the various ways to implement widgets in
|
||||
> Ratatui. It demonstrates how to implement the `Widget` trait on a type,
|
||||
> a reference, and a mutable reference. It also shows how to use the
|
||||
> `WidgetRef` trait to render boxed widgets.
|
||||
|
||||
- [d5477b5](https://github.com/ratatui/ratatui/commit/d5477b50d54fc43c75924c2b2584331f039ed261) *(examples)* Use ratatui::crossterm in examples by @joshka in [#1315](https://github.com/ratatui/ratatui/pull/1315)
|
||||
|
||||
- [730dfd4](https://github.com/ratatui/ratatui/commit/730dfd4940809fb2d8a15ed2976a4016c2227114) *(examples)* Show line gauge in demo example by @montmorill in [#1309](https://github.com/ratatui/ratatui/pull/1309)
|
||||
|
||||
- [9ed85fd](https://github.com/ratatui/ratatui/commit/9ed85fd1dddc68757e9258b2e99dbd25f7ba0768) *(table)* Fix incorrect backticks in `TableState` docs by @airblast-dev in [#1342](https://github.com/ratatui/ratatui/pull/1342)
|
||||
|
||||
- [6d1bd99](https://github.com/ratatui/ratatui/commit/6d1bd99544ab3b82b2494ca514f307234c6f2477) *(uncategorized)* Minor grammar fixes by @matta in [#1330](https://github.com/ratatui/ratatui/pull/1330)
|
||||
|
||||
- [097ee86](https://github.com/ratatui/ratatui/commit/097ee86e399abefdca6505550287035967a7b035) *(uncategorized)* Remove superfluous doc(inline) by @EdJoPaTo in [#1310](https://github.com/ratatui/ratatui/pull/1310)
|
||||
|
||||
> It's no longer needed since #1260
|
||||
|
||||
- [3fdb5e8](https://github.com/ratatui/ratatui/commit/3fdb5e8987ca811c094593b0f816a64900880d23) *(uncategorized)* Fix typo in terminal.rs by @mrjackwills in [#1313](https://github.com/ratatui/ratatui/pull/1313)
|
||||
|
||||
### Testing
|
||||
|
||||
- [0d5f3c0](https://github.com/ratatui/ratatui/commit/0d5f3c091f838888a3cfb69c6de3a0a6af739bbe) *(uncategorized)* Avoid unneeded allocations in assertions by @mo8it in [#1335](https://github.com/ratatui/ratatui/pull/1335)
|
||||
|
||||
> A vector can be compared to an array.
|
||||
|
||||
### Miscellaneous Tasks
|
||||
|
||||
- [65da535](https://github.com/ratatui/ratatui/commit/65da5357455b11cd395757182f07b0ee22025e4b) *(ci)* Update release strategy by @orhun in [#1337](https://github.com/ratatui/ratatui/pull/1337)
|
||||
>
|
||||
> closes #1232
|
||||
>
|
||||
> Now we can trigger point releases by pushing a tag (follow the
|
||||
> instructions in `RELEASE.md`). This will create a release with generated
|
||||
> changelog.
|
||||
>
|
||||
> There is still a lack of automation (e.g. updating `CHANGELOG.md`), but
|
||||
> this PR is a good start towards improving that.
|
||||
|
||||
- [57d8b74](https://github.com/ratatui/ratatui/commit/57d8b742e55b75674e271a83339fc585f62d3a6d) *(ci)* Use cargo-docs-rs to lint docs by @joshka in [#1318](https://github.com/ratatui/ratatui/pull/1318)
|
||||
|
||||
- [8b624f5](https://github.com/ratatui/ratatui/commit/8b624f5952af940d570bc95d45b6bd7bf8018dd0) *(maintainers)* Remove EdJoPaTo by @EdJoPaTo in [#1314](https://github.com/ratatui/ratatui/pull/1314)
|
||||
|
||||
- [23516bc](https://github.com/ratatui/ratatui/commit/23516bce76af91586b697db339da6b895c9e7151) *(uncategorized)* Rename ratatui-org to ratatui by @joshka in [#1334](https://github.com/ratatui/ratatui/pull/1334)
|
||||
|
||||
> All urls updated to point at https://github.com/ratatui
|
||||
>
|
||||
> To update your repository remotes, you can run the following commands:
|
||||
>
|
||||
> ```shell
|
||||
> git remote set-url origin https://github.com/ratatui/ratatui
|
||||
> ```
|
||||
|
||||
### Build
|
||||
|
||||
- [0256269](https://github.com/ratatui/ratatui/commit/0256269a7f978c6bba6fcae3e35517b42b3dc846) *(uncategorized)* Simplify Windows build by @joshka in [#1317](https://github.com/ratatui/ratatui/pull/1317)
|
||||
|
||||
> Termion is not supported on Windows, so we need to avoid building it.
|
||||
>
|
||||
> Adds a conditional dependency to the Cargo.toml file to only include
|
||||
> termion when the target is not Windows. This allows contributors to
|
||||
> build using the `--all-features` flag on Windows rather than needing
|
||||
> to specify the features individually.
|
||||
|
||||
### New Contributors
|
||||
|
||||
* @nfachan made their first contribution in [#1329](https://github.com/ratatui/ratatui/pull/1329)
|
||||
* @LucasPickering made their first contribution in [#1320](https://github.com/ratatui/ratatui/pull/1320)
|
||||
* @montmorill made their first contribution in [#1309](https://github.com/ratatui/ratatui/pull/1309)
|
||||
|
||||
**Full Changelog**: https://github.com/ratatui/ratatui/compare/v0.28.0...v0.28.1
|
||||
|
||||
## [0.28.0](https://github.com/ratatui/ratatui/releases/tag/v0.28.0) - 2024-08-07
|
||||
|
||||
_"If you are what you eat, then I only want to eat the good stuff." – Remy_
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
[package]
|
||||
name = "ratatui"
|
||||
version = "0.28.0" # crate version
|
||||
version = "0.28.1" # crate version
|
||||
authors = ["Florian Dehau <work@fdehau.com>", "The Ratatui Developers"]
|
||||
description = "A library that's all about cooking up terminal user interfaces"
|
||||
documentation = "https://docs.rs/ratatui/latest/ratatui/"
|
||||
|
|
|
|||
Loading…
Reference in a new issue