Purr 26.2.64800

Purr

<img src="Purr/wwwroot/logo.png" align="right" width="200" alt="Purr Logo" />

Purr is a .NET 10 CLI tool designed to automate the testing of GitHub Pull Requests. It monitors a repository for new or updated PRs, clones them, executes defined test steps in a secure Landlock sandbox, launches a Playwright browser to navigate to the application, and streams the live session to a remote viewer.

Goal

The goal of this library is to provide a secure and interactive way to preview and test changes in pull requests automatically.

Installation

Install Purr as a global .NET tool:

dotnet tool install purr --global

Usage

Run Purr with the following command:

purr <owner> <repo> [github_token]

Example:

purr myuser myrepo ghp_xxxxx

How to Develop

1. Prerequisites:

   • .NET 10 SDK
   • Playwright dependencies, automatically installed on first run
   • Linux environment with Landlock support (Kernel 5.13+)

2. Build:

   dotnet build
   

3. Run:

   dotnet run -- <owner> <repo> [github_token]
   

   Example:

   dotnet run -- myuser myrepo ghp_xxxxx
   

Project Structure

• Purr/: Main CLI application source code.
• purr.yml: Configuration file expected in the target repository.

Remote Viewer

The tool starts a web server (default: port 9000) that streams the browser session. Navigate to the displayed URL (e.g., http://localhost:9000) to view and interact with the running application.