manongjohn aab4be
# Testing Pull Requests (PRs)
manongjohn aab4be
manongjohn aab4be
When a PR is submitted, it is compiled automatically by AppVeyor and Travis CI. The AppVeyor build creates an artifact which contains the OpenToonz executable and supporting DLLs needed to run.  You can easily download this artifact and run it to test out the PR before it is merged.
manongjohn aab4be
manongjohn aab4be
## Pre-Testing Notes
manongjohn aab4be
- This can only be tested on Windows. There is no OSX or Linux build that can be tested.
manongjohn aab4be
- You need to have OpenToonz already installed.  Do not uninstall.
manongjohn aab4be
- Your current personal preferences and settings will be used.
manongjohn aab4be
  - Personal settings can change if you change them while testing.
manongjohn aab4be
  - It is recommended that you backup your `C:\OpenToonz #.# stuff` folder before testing a PR.
manongjohn aab4be
- The AppVeyor build does not contain an updated `C:\OpenToonz #.# stuff` folder so any PR changes to default configurations (i.e. stylesheets, FXs, brushes, etc) are not automatically included.
manongjohn aab4be
- It is recommended when testing to use new scenes that you can throw away.
manongjohn aab4be
  - If you decide to test on an existing scene, back it up first!
manongjohn aab4be
manongjohn aab4be
## Downloading and Testing AppVeyor Builds
manongjohn aab4be
manongjohn aab4be
- Go to the PR you are interested in checking out.
manongjohn aab4be
manongjohn aab4be
- Scroll to the bottom of the page and look for the green-outlined box with `All checks have passed` in it. Click on `Show all checks` next to it.
manongjohn aab4be
manongjohn aab4be
![](./testing_pr_1.JPG)
manongjohn aab4be
manongjohn aab4be
- Look for where it says `AppVeyor build succeeded` and click on the `Details` next to it.
manongjohn aab4be
manongjohn aab4be
![](./testing_pr_2.JPG)
manongjohn aab4be
manongjohn aab4be
- Click on `Configuration: Release`.
manongjohn aab4be
manongjohn aab4be
![](./testing_pr_3.JPG)
manongjohn aab4be
manongjohn aab4be
- On the right side of the page, click on `Artifacts`.
manongjohn aab4be
manongjohn aab4be
![](./testing_pr_4.JPG)
manongjohn aab4be
manongjohn aab4be
- Click on the OpenToonz `.zip` file to begin the download.
manongjohn aab4be
manongjohn aab4be
![](./testing_pr_5.JPG)
manongjohn aab4be
manongjohn aab4be
- Once download is complete, go to your Downloads folder and extract the contents of the .zip file anywhere on your computer.
manongjohn aab4be
 - You should extract into a separate folder. 
manongjohn aab4be
 - ⚠️ **Do not overwrite your current OpenToonz installation!**
manongjohn aab4be
manongjohn aab4be
- Enter the folder you extracted everything into and double-click the OpenToonz executable to start.
manongjohn aab4be
manongjohn aab4be
- Test away!  Report any suggestions or issues related to the change in the PR comments.
manongjohn aab4be
manongjohn aab4be
- You can safely delete the .zip file and the folder you created when you are done.