feat: add tui-qrcode crate

Author: joshka

tui-qrcode/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "tui-qrcode"
+version = "0.1.0"
+description = "A Ratatui widget for displaying QR codes in the terminal"
+documentation = "https://docs.rs/tui-qrcode"
+
+authors.workspace = true
+license.workspace = true
+repository.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+categories.workspace = true
+keywords.workspace = true
+
+[dependencies]
+color-eyre.workspace = true
+qrcode = { version = "0.14.1", default-features = false }
+ratatui.workspace = true
+
+[dev-dependencies]
+ratatui = { workspace = true, features = ["crossterm"] }

tui-qrcode/README.md

@@ -0,0 +1,71 @@
+# TUI QR Code
+
+<!-- cargo-rdme start -->
+
+TUI QR Code is a library for rendering QR codes in a terminal using the [ratatui] crate.
+
+## Usage
+
+Add qrcode and tui-qrcode to your Cargo.toml. You can disable the default features of qrcode as
+we don't need the code which renders the QR code to an image.
+
+```shell
+cargo add qrcode tui-qrcode --no-default-features
+```
+
+## Example
+
+This example can be found in the `examples` directory of the repository.
+
+```rust
+use qrcode::QrCode;
+use ratatui::{crossterm::event, DefaultTerminal, Frame};
+use tui_qrcode::{Colors, QrCodeWidget};
+
+fn main() -> color_eyre::Result<()> {
+    color_eyre::install()?;
+    let terminal = ratatui::init();
+    let result = run(terminal);
+    ratatui::restore();
+    result
+}
+
+fn run(mut terminal: DefaultTerminal) -> color_eyre::Result<()> {
+    loop {
+        terminal.draw(render)?;
+        if matches!(event::read()?, event::Event::Key(_)) {
+            break Ok(());
+        }
+    }
+}
+
+fn render(frame: &mut Frame) {
+    let qr_code = QrCode::new("https://ratatui.rs").expect("failed to create QR code");
+    let widget = QrCodeWidget::new(qr_code).colors(Colors::Inverted);
+    frame.render_widget(widget, frame.area());
+}
+```
+
+Renders the following QR code:
+
+```text
+█████████████████████████████████
+█████████████████████████████████
+████ ▄▄▄▄▄ █▄ ▄▄▄ ████ ▄▄▄▄▄ ████
+████ █   █ █▄▄▄█▀▄██ █ █   █ ████
+████ █▄▄▄█ █▀   ▄▀ ███ █▄▄▄█ ████
+████▄▄▄▄▄▄▄█▄▀▄█ ▀▄▀ █▄▄▄▄▄▄▄████
+████ █▄▀▀▀▄▄▀▄▄  ▄█▀▄█▀ █▀▄▀ ████
+██████▀█  ▄▀▄▄▀▀ ▄ ▄█ ▄▄█ ▄█▄████
+████▄▀▀▀▄▄▄▄▀█▄▄█  ▀ ▀ ▀███▀ ████
+████▄▄ ▀█▄▄▀▄▄ ▄█▀█▄▀█▄▀▀ ▄█▄████
+████▄▄█▄██▄█ ▄▀▄ ▄█  ▄▄▄ ██▄▀████
+████ ▄▄▄▄▄ █▄▄▄▀ ▄ ▀ █▄█ ███ ████
+████ █   █ ██ ███  ▄▄ ▄▄ █▀ ▄████
+████ █▄▄▄█ █▄▀ ▄█▀█▀ ▄█  ▄█▄▄████
+████▄▄▄▄▄▄▄█▄▄█▄▄▄██▄█▄██▄██▄████
+█████████████████████████████████
+▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀    
+```
+
+<!-- cargo-rdme end -->

tui-qrcode/examples/qrcode.rs

@@ -0,0 +1,26 @@
+use qrcode::QrCode;
+use ratatui::{crossterm::event, style::Stylize, DefaultTerminal, Frame};
+use tui_qrcode::{Colors, QrCodeWidget};
+
+fn main() -> color_eyre::Result<()> {
+    color_eyre::install()?;
+    let terminal = ratatui::init();
+    let result = run(terminal);
+    ratatui::restore();
+    result
+}
+
+fn run(mut terminal: DefaultTerminal) -> color_eyre::Result<()> {
+    loop {
+        terminal.draw(render)?;
+        if matches!(event::read()?, event::Event::Key(_)) {
+            break Ok(());
+        }
+    }
+}
+
+fn render(frame: &mut Frame) {
+    let qr_code = QrCode::new("https://ratatui.rs").expect("failed to create QR code");
+    let widget = QrCodeWidget::new(qr_code).colors(Colors::Inverted).blue();
+    frame.render_widget(widget, frame.area());
+}