Diff stat

In plain words

How many lines were added (green) and removed (red) in a change.

Lines added and removed, with a row of green and red blocks, as in the git panel of a code editor.

ui.diff_stat · Category: Data · Full reference →

Preview

Code

pz.column([
    pz.row([ui.label("render.rs", mono=True), pz.hspace(), ui.diff_stat(42, 9)], align="center"),
    pz.row([ui.label("app.py", mono=True), pz.hspace(), ui.diff_stat(3, 27)], align="center"),
    pz.row([ui.label("README.md", mono=True), pz.hspace(), ui.diff_stat(12, 0)], align="center"),
], spacing=10, width=320)

When to use

• Next to a file, commit or pull request in a list of changes.

Usage

import pyzed as pz
from pyzed import ui

pz.column([
    pz.row([ui.label("render.rs", mono=True), pz.hspace(), ui.diff_stat(42, 9)], align="center"),
    pz.row([ui.label("app.py", mono=True), pz.hspace(), ui.diff_stat(3, 27)], align="center"),
    pz.row([ui.label("README.md", mono=True), pz.hspace(), ui.diff_stat(12, 0)], align="center"),
], spacing=10, width=320)

Variants

About these captures

Each capture is recorded by pyzed itself, off-screen at 2x, in One Dark or One Light to match this site’s theme, and cropped to the component so it shows at its real size. The pointer hovers, presses or types into it; a component that does not react to the pointer cycles through a few themes. With reduced motion you see the first frame. Open Code under a capture to see the snippet that draws it; free names such as on_save stand for your own callbacks.

Options

Mostly added

Code

ui.diff_stat(42, 3)

Mostly removed

Code

ui.diff_stat(2, 57)

Only added

Code

ui.diff_stat(12, 0)

blocks=10

Code

ui.diff_stat(120, 40, blocks=10)

Events

Diff stat has no events of its own: it shows what you give it. Like every widget it also has the 18 common events (click, double_click, right_click, mouse_enter, drag, key_down, resize…), attached with .on(...): see Events and Events of every component.

Properties and API

ui.diff_stat

diff_stat(added, removed, *, blocks=5, theme=None)

+12 −3 with GitHub-style colored blocks.

Property	Default	Description
added	required	Lines added.
removed	required	Lines removed.
blocks	5	Number of blocks.
theme	None	Theme to use instead of the current one (pyzed.theme.current()).

Full reference →

Related

BadgeA small pill for statuses, versions and counters.

TreeA collapsible file tree with icons and git colors.