How do I set up and use Trevor for my Node.js project?

Install Trevor globally via 'npm install --global trevor', then run 'trevor' in your project directory with a .travis.yml file. It will parse the config and spin up Docker containers for each Node version to run tests.

Can Trevor test projects in languages like Python or Java?

No, Trevor is designed specifically for Node.js projects as it interprets .travis.yml for Node.js versions. It does not support other languages or testing frameworks outside this scope.

Trevor vs Travis CI: what's the main difference?

Trevor runs Travis CI's test matrix locally using Docker, providing faster feedback without remote servers. However, it lacks Travis CI's cloud features like collaboration tools or integrations with other services.

How to debug test failures when using Trevor?

Since Trevor runs tests in isolated Docker containers, check container logs for error messages. The sparse documentation means you may need to rely on Docker debugging skills or Travis CI's error patterns for troubleshooting.

Is Trevor compatible with Windows or macOS?

Trevor should work on any OS with Docker installed, but the README doesn't provide OS-specific instructions, which could lead to setup challenges on Windows or older macOS versions.

Trevor or using nvm for local Node testing?

Trevor automates multi-version testing via Docker based on .travis.yml, ideal for CI replication. nvm is better for manual version switching and single-version testing, offering more control but less automation.

Open-Awesome

trevor

MITJavaScriptv2.4.1

A local Travis CI clone that runs tests across multiple Node.js versions using Docker.

GitHub

2.1k stars51 forks0 contributors

What is trevor?

Trevor is a command-line tool that acts as a local version of Travis CI, allowing developers to run their test suites across multiple Node.js versions without leaving their local machine. It solves the problem of manually switching Node versions or relying on remote CI services for multi-environment testing by using Docker to spin up isolated containers for each version specified in the project's `.travis.yml` file.

Target Audience

Node.js developers who use Travis CI for testing across multiple Node versions and want to run those tests locally before pushing code.

Value Proposition

Developers choose Trevor because it provides a seamless local testing experience that mirrors Travis CI's behavior, reducing dependency on external CI services and enabling faster feedback loops during development.

Overview

🚦 Your own mini Travis CI to run tests locally

Use Cases

Best For

Testing Node.js projects across multiple Node versions locally
Running Travis CI test matrices without pushing code
Keeping git history clean by testing before commits
Debugging CI failures in a local environment
Projects with complex Travis CI configurations
Developers who want faster test feedback without CI delays

Not Ideal For

Projects using CI/CD systems other than Travis CI, like GitHub Actions or CircleCI
Teams developing in languages beyond Node.js or needing multi-language testing
Environments where Docker is unavailable or restricted, such as some corporate systems

Pros & Cons

Pros

Local Travis CI Emulation

Reads .travis.yml to replicate Travis CI's test matrix locally, allowing developers to run tests without pushing code to remote servers.

Multi-Node Version Testing

Automatically runs tests across all Node.js versions specified in config, eliminating manual switching with tools like nvm or n.

Isolated Docker Environments

Uses Docker containers for each test run, ensuring clean and consistent environments that mirror CI server conditions.

Pre-Push Validation

Enables full test suite execution locally before commits, helping catch issues early and maintain clean git history.

Cons

Docker Dependency

Requires Docker to be installed and running, which can be a barrier for users on systems without Docker or those unfamiliar with containerization.

Travis CI Lock-in

Only works with .travis.yml configurations, making it ineffective for projects using other CI systems or custom workflows not tied to Travis.

Limited Language Support

Focused solely on Node.js, so it cannot be used for testing projects in other programming languages or multi-language setups.

Sparse Documentation

The README provides minimal examples and no guidance on advanced usage, error handling, or integration, leaving users to figure out edge cases on their own.

Open Source Alternative To

trevor is an open-source alternative to the following products:

Travis CI

Travis CI is a continuous integration service that automatically builds and tests software projects hosted on GitHub, supporting multiple programming languages and deployment workflows.

Frequently Asked Questions

Related Projects

Puppeteer

JavaScript API for Chrome and Firefox

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

Stars93,344

Forks6,139

Last commit19 hours ago

Jest

Delightful JavaScript Testing.

Stars45,454

Forks6,712

Last commit3 days ago

Mocha

☕️ Classic, reliable, trusted test framework for Node.js and the browser

Stars22,904

Forks3,144