A Windows Subsystem for Linux (WSL)-based testing framework written in Python.
WSL must be installed on your machine, and presently, WSL distros you wish to use in your pipeline definitions will need to currently be installed (i.e. Ubuntu, Alpine, and installed under that name).
Clone this repo, and install from source:
pip install -e .or from PyPi:
pip install py-wslrunand run the CLI:
wslrun --pipeline your_config.json
Define a pipeline in your project directory:
{
"name": "PS Test",
"description": "Tests building in multiple environments",
"pullPolicy": "Never",
"ciMode": "False",
"stages": [
{
"image": "Alpine",
"name": "Build on distro with a passing job",
"steps": [
"sudo apk --update add musl-dev",
"env CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -v -x -o package-amd64-alpine"
]
},
{
"image": "Ubuntu-22.04",
"name": "ubuntu-jammy",
"steps": [
"lsb_release -a"
]
},
{
"image": "AlpineLatest",
"name": "Build on image I know doesn't exist",
"steps": [
"env GOOS=linux GOARCH=amd64 go build -v -x -o package-amd64-alpine"
]
}
]
}or in YAML:
---
name: PS Test
description: Tests building in multiple environments
pullPolicy: Never
ciMode: 'False'
stages:
- image: Alpine
name: Build on distro with a passing job
steps:
- sudo apk --update add musl-dev
- env CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -v -x -o package-amd64-alpine
- image: Ubuntu-22.04
name: Build on distro I know will fail
steps:
- GOOS=linux GOARCH=amd64 go build -v -x -o package-amd64-ubuntu
- image: AlpineLatest
name: Build on image I know doesn't exist
steps:
- GOOS=linux GOARCH=amd64 go build -v -x -o package-amd64-alpineFor each stage, an image, name, and list of steps will be required.
Run the test (for example, as a pre-commit hook) with:
wslrun --pipeline build.json
and see the test results report, which will look like this:
PS C:\Users\you\repos\project> python .\wslrun --pipeline .\build.json
wslExec (image: AlpineDub): sudo apk --update add musl-dev
✔️: sudo apk --update add musl-dev
wslExec (image: AlpineDub): go build
✔️: go build
🔔: Build on distro with a passing job completed.
Pipeline completed:
🧾 Report: Build on distro with a passing job...
{'completions': '2/2'}
🧾 Report: Build on distro I know will fail...
{'completions': '0/0, Image Unavailable: 1'}
🧾 Report: Build on image I know doesn't exist...
{'completions': '0/0, Image Unavailable: 4294967295'}
Completed.- Remote testing mode for Server 2019 in progress (part of a CI/CD offering).
- Image/Distro registry and management in progress.