An open API service indexing awesome lists of open source software.

https://github.com/dennisbergevin/pwgo

Multi-list interactive cli tool to run your Playwright suite.
https://github.com/dennisbergevin/pwgo

bubbletea charmbracelet cli go playwright tui

Last synced: 2 months ago
JSON representation

Multi-list interactive cli tool to run your Playwright suite.

Awesome Lists containing this project

README

          


️ pwgo



Multi-list interactive cli tool to run your Playwright suite.





Pwgo logo

## Features

- 👟 Interactive local run replacement command for `npx playwright test`
- 📓 New selectable list view of available files, tests, and tags
- ⏳ Filterable list search
- 🔦 Tags, test and project total descriptive helpers

![Demo](./assets/pwgo-demo.gif)

#### Table of Contents

- [Installation](#installation)
- [Command line arguments](#command-line-arguments)
- [Help mode](#help-mode)
- [Keyboard controls](#keyboard-controls)
- [Selecting items](#selecting-items)

---

## Installation

### Homebrew

```console
brew tap dennisbergevin/tools
brew install pwgo
```

### Go

Install with Go:

```console
go install github.com/dennisbergevin/pwgo@latest
```

Or grab a binary from [the latest release](https://github.com/dennisbergevin/pwgo/releases/latest).

---

## Command line arguments

> [!NOTE]
> For a complete list of options/arguments to pass to Playwright, refer to https://playwright.dev/docs/test-cli.

### Help mode

Common options are included in the help menu:

```bash
pwgo --help
```

![Help demo](./assets/pwgo-help.png)

### Keyboard controls

> [!NOTE]
> All keyboard controls are displayed on the bottom of the program. Additional commands can be seen by pressing the '?' key.

| Keys | Action |
| :-----------------------------------------: | :-----------------------------------: |
| Up/k | Move to selection above current |
| Down/j | Move to selection below current |
| Right/l/pgdn | Move to next page on current list |
| Left/h/pgdn | Move to previous page on current list |
| g/home | Go to start of current list |
| G/end | Go to end of current list |
| Space | Select current |
| Shift + Right/l | Toggle to next list |
| Shift + Left/h | Toggle to previous list |
| / | Open Filter search |
| Enter | Apply Filter/Run selection(s) |
| Esc | Remove Filter |
| Ctrl + c/q | Quit |
| ? | Open/Close help menu |

## Selecting items

Items can be selected via the Space key, which will add the item to the `Selected` list.

Items can be removed from the `Selected` list and returned back to their original list via the Space key.

> [!NOTE]
> If no items have been added to the `Selected` list, pressing Enter on an item will run that item.

![Selecting demo](./assets/pwgo-selecting.gif)