Playground
Welcome to gitStream Playground! This platform allows you to thoroughly test gitStream automations before deploying them into the .cm
rule file on any GitHub pull request of your choice.
Getting Started
Accessing gitStream Playground
To access gitStream Playground, visit https://app.gitstream.cm/playground. To be able to test automations of private repository PRs, log in with your GitHub account credentials.
Interface Overview
The gitStream Playground interface consists of the following sections:
- Login \ User icon: supports the following actions
- Login
- Logout
- View user
- Change organization
- Pull Request Link: An input textbox for a link to the pull request
- cm editor: Code input box where you can write automations to be executed by the playground.
estimated_time_to_review
andsafe_changes
are provided by default. - Output section, with the following tabs:
Output
- shows syntax errors when the.cm
automation syntax is wrong. After running gitStream - it shows the expected result of the automation on the chosen Pull Request.Context Variables
- Shows the values of all Context variables of the chosen Pull Request.
Testing Automations
Selecting a Pull Request
On GitHub, navigate to any pull request, copy its link, and paste it onto the "Pull request link" box. If the PR is part of a private repo, you must also log in to the playground with a GitHub user accessible to this repository.
Running gitStream
- Add the desired automations to the editor. Make sure there are no syntax errors
- Click "Run gitStream."
- The rule engine loads the PR and runs the automations defined in the
.cm
editor.
Viewing Results
The automation results will be shown in the "Output" tab at the bottom of the interface. Context Variables will be shown in the "Context Variables" tab.
Feedback and Support
For additional assistance or to provide feedback, please open an issue on our GitHub issues page