#pull-request

app revq

Review and query your pull requests

2 releases

0.1.1 Sep 15, 2024
0.1.0 Sep 12, 2024

#689 in Command line utilities

MIT license

640KB
524 lines

revq

revq is a command-line tool designed to streamline the process of reviewing, searching, and filtering GitHub pull requests.

demo

Table of Contents

Features

  • List pull requests with ease
  • Filter pull requests by author
  • Filter pull requests by organization
  • List pull requests where a review is requested
  • Select and open multiple pull requests simultaneously in your default browser
  • User-friendly command-line interface

Installation

You can install revq using one of the following methods:

Using Cargo

If you have Rust's package manager, Cargo, installed, you can install revq with:

cargo install revq

Using Homebrew

For macOS users, you can install revq using Homebrew:

brew install k3ii/tap/revq

Check the release page to install the pre-built binaries.

Usage

The general syntax for using revq is:

revq [OPTIONS] [COMMAND]

Options and Subcommands

  • -u, --username <USERNAME> Specify GitHub username
  • -o, --org Use organization PRs
  • -r, --req Show PRs where review is requested
  • --all Show all PRs for organization (only works with --org)
  • -h, --help Print help information
  • -V, --version Print version information

Examples

List your pull requests:

revq

List pull requests for a specific user:

revq -u username

List your pull requests for your organization:

revq -o

List pull requests for a specific user in your organization:

revq -o -u username

List pull requests where your review is requested:

revq -r

List pull requests where your review is requested in your organization:

revq -r -o

List all pull requests for your organization:

revq -o --all

Configuration

To get started with revq, follow these steps:

  1. Generate a GitHub Personal access tokens (Fine-grained token) with Content permission having Read-only access.
  2. Initialize revq with your GitHub token:
revq init
  1. Follow the prompts to enter your GitHub username, token and organization optionally.

To reinitialize or update your configuration:

revq init --force

Motivation

revq was born out of a desire to learn Rust programming and improve upon a simple bash script created by my mentor.

revq offers several advantages over similar tools like gh pr:

  • Can be run from any directory in your terminal
  • Allows filtering of pull requests based on author and organization
  • Enables selection and opening of multiple PRs simultaneously
  • Written in Rust for performance and reliability

Future Work

We have exciting plans for future enhancements to revq:

  • Allow filtering by mentions
  • Allow filtering by assignees
  • Support for multiple organizations

Contributing

Contributions are welcome to revq! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any problems or have any questions, please open an issue on our GitHub repository.

Dependencies

~23–41MB
~609K SLoC