TestDino CLI (tdpw)


TestDino CLI - Upload Playwright test reports and manage test metadata for the TestDino
platform.

Quick Start

``bash


Upload test reports

npx tdpw upload ./playwright-report --token="your-api-token"

Cache test metadata for intelligent reruns

npx tdpw cache --token="your-api-token"

Get previously failed tests

npx tdpw last-failed --token="your-api-token"
`

Installation

$3

`bash
npx tdpw --token="your-token"
`

$3

`bash
npm install -g tdpw
tdpw --token="your-token"
`

$3

`bash
npm install --save-dev tdpw
`

Commands

$3

Upload Playwright test reports to TestDino.

`bash


Basic upload

npx tdpw upload ./playwright-report --token="your-token"

Upload with all attachments (images, videos, traces)

npx tdpw upload ./playwright-report --token="your-token" --upload-full-json

Upload with environment tag

npx tdpw upload ./playwright-report --token="your-token" --environment="staging"
`

Options:

| Option | Description | Default |
| ----------------------- | ------------------------------------------------ | --------- |
| | Directory containing Playwright reports | Required |
| -t, --token | TestDino API token | Required |
| --environment | Target environment tag (staging, production, qa) | unknown |
| --upload-images | Upload image attachments | false |
| --upload-videos | Upload video attachments | false |
| --upload-html | Upload HTML reports | false |
| --upload-traces | Upload trace files | false |
| --upload-files | Upload file attachments (.md, .pdf, .txt, .log) | false |
| --upload-full-json | Upload all attachments | false |
| -v, --verbose | Enable verbose logging | false |

$3

Store test execution metadata after Playwright runs for intelligent reruns.

`bash


Basic usage

npx tdpw cache --token="your-token"

With custom working directory

npx tdpw cache --working-dir ./test-results --token="your-token"
`

Options:

| Option | Description | Default |
| ---------------------- | ---------------------------------- | ----------------- |
| --working-dir | Directory to scan for test results | Current directory |
| --cache-id | Custom cache ID override | Auto-detected |
| -t, --token | TestDino API token | Required |
| -v, --verbose | Enable verbose logging | false |

$3

Retrieve previously failed tests for selective reruns.

`bash


Get failed test files

npx tdpw last-failed --token="your-token"

Run only failed tests with Playwright

npx playwright test $(npx tdpw last-failed --token="your-token")
`

Options:

| Option | Description | Default |
| --------------------- | --------------------------- | ------------- |
| --cache-id | Custom cache ID override | Auto-detected |
| --branch | Custom branch name override | Auto-detected |
| --commit | Custom commit hash override | Auto-detected |
| -t, --token | TestDino API token | Required |
| -v, --verbose | Enable verbose logging | false |

Environment Variables

`bash
export TESTDINO_TOKEN="your-api-token"
export TESTDINO_TARGET_ENV="staging" # Optional: Testrun Target environment
`

CI/CD Integration

$3

`yaml
name: Playwright Tests
on: [push, pull_request]

jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '18'

- name: Install dependencies
run: npm ci

- name: Install Playwright
run: npx playwright install --with-deps

- name: Run tests
run: npx playwright test

- name: Upload reports to TestDino
if: always()
run:
npx tdpw upload ./playwright-report --token="${{ secrets.TESTDINO_TOKEN }}"
--upload-full-json
`

$3

`yaml
playwright-tests:
image: node:18
script:
- npm ci
- npx playwright install --with-deps
- npx playwright test
- npx tdpw upload ./playwright-report --token="$TESTDINO_TOKEN" --upload-full-json
when: always
`

$3

`groovy
pipeline {
agent any
environment {
TESTDINO_TOKEN = credentials('testdino-token')
}
stages {
stage('Test') {
steps {
sh 'npm ci'
sh 'npx playwright install --with-deps'
sh 'npx playwright test'
sh 'npx tdpw upload ./playwright-report --token="$TESTDINO_TOKEN" --upload-full-json'
}
}
}
}
`

Authentication

$3

1. Sign up at TestDino
2. Navigate to Project > Settings > API Tokens
3. Generate a new token
4. Store it securely in your CI/CD secrets

$3

- Never commit tokens to version control
- Use environment variables or CI/CD secrets
- Rotate tokens regularly

Example Workflows

$3

`bash


Run tests and upload results


npx playwright test
npx tdpw upload ./playwright-report --token="$TESTDINO_TOKEN" --upload-full-json
`

$3

`bash


First run: execute all tests and cache metadata

npx playwright test
npx tdpw cache --token="$TESTDINO_TOKEN"

Subsequent runs: execute only previously failed tests

npx playwright test $(npx tdpw last-failed --token="$TESTDINO_TOKEN")
`

$3

`bash
#!/bin/bash


Run all tests

npx playwright test
TEST_EXIT_CODE=$?

Cache test metadata

npx tdpw cache --token="$TESTDINO_TOKEN"

Upload reports

npx tdpw upload ./playwright-report --token="$TESTDINO_TOKEN" --upload-full-json

Rerun failed tests if any

if [ $TEST_EXIT_CODE -ne 0 ]; then
FAILED=$(npx tdpw last-failed --token="$TESTDINO_TOKEN")
if [ -n "$FAILED" ]; then
npx playwright test $FAILED
fi
fi
``

Support

- Documentation: docs.testdino.com
- Issues: GitHub Issues
- Email: support@testdino.com

---

Made with ❤️ by the TestDino team