Velocity

Test runner (and community) for Meteor apps. Under heavy development.

What is Velocity?

Find out more by watching the Intro to Velocity talk that Robert, Sam, and Mike did at the June 2014 Meteor Devshop!

Getting Started

The Velocity package itself is not something that you include, rather you use Velocity-compatible framework.

To see frameworks in action, have a look at the velocity-examples repository.

Troubleshooting

Sometimes things break and its useful to get more debugging info. Most of the test frameworks support some kind of debugging environment variable flag. You can usually see a lot more details about what's happening if you run your app with this command:

$ DEBUG=1 JASMINE_DEBUG=1 VELOCITY_DEBUG=1 VELOCITY_DEBUG_MIRROR=1 meteor

Reporting bugs

Please report bugs directly on the issues of the framework(s) you are using. Framework authors will then post issues to the core if they are core issues.

##Velocity Compatible Packages

Frameworks

Below is a list of the currently available frameworks.

####Fully Integrated

These frameworks have an example in the velocity-examples repository. They also include a set of sample tests that the framework can add directly to the reporter when you first install the framework.

sanjo:jasmine - Write client and server unit and integration tests with Jasmine.
mike:mocha - A Velocity version of mocha-web. Runs mocha tests in the Meteor context which is great for integration testing.
xolvio:cucumber - Use Gherkin-syntax cucumber to test your app. Integrated nicely with meteor-webdriver

####Partially Integrated

These frameworks are very usable, and they are placed under this section as they currently don't have an example app and do not offer a sample-test button in the reporter.

clinical:nightwatch - run acceptance tests with automated browsers using the Nightwatch bridge to Selenium
nblazer:casperjs - CasperJS end to end test integration

Reporters

Reporters display test results.

velocity:html-reporter - Adds an overlay to your app indicating test success/failure (green/red dot in top right). Click dot for test details. meteor add velocity:html-reporter

Mirrors

Mirrors are used by test frameworks to run tests within. Tests are typically destructive and as such require a different database. Mirrors run a parallel version of your app with a different database as not to intrude on the main development workflow.

node-soft-mirror - This mirror offers an extremely fast startup time. It creates a mirror using a node form from within the running meteor process.

Other

xolvio:webdriver - Adds webdriver.io to any test framework for UI testing. Uses PhantomJS in GhostDriver mode for ultra-fast UI testing

Test Framework Authors

We would love to add your framework to the list! Take a look at how some of these interface with velocity and let us know about your framework on the velocity-core google group.

Please see the velocity-wiki for basic instructions on making your test framework work with Velocity.

Also, be sure to check out the documentation for the public API. You can view them in the browser by cloning this repo and then running: open docs/classes/Velocity.html

A few notes on being velocity-compatible:

Register testing framework to Velocity

Use Velocity.registerTestingFramework(frameworkName, options) to register your package as testing framework. You can find a description of the expected arguments in the docs.

Sample Tests

Please put some sample tests in a directory named sample-tests at the root of your package. These will be used by the velocity-quick-start package and also allows users to click a button in the html-reporter to have them added to their apps.

Debug output

Please include a way to get more detailed info about your frameworks' test runs.

One way that we've done it is by having an environment flag that the user can set. Feel free to use VELOCITY_DEBUG if you'd like.

For example, you could write your logging like this:

var DEBUG = process.env.VELOCITY_DEBUG;
DEBUG && console.log('[my-framework] helpful debugging info', someVar)

Writing a new Mirror Package

See instructions here

For velocity:core maintainers

Developing with a local version of velocity:core

Clone https://github.com/meteor-velocity/velocity-examples.git
Create a symlink to your local velocity:core package:

cd velocity-examples/leaderboard-jasmine
mkdir packages
cd packages
# Replace ~/velocity with your path 
ln -s ~/velocity velocity:core

Start the velocity example app. It will use your local velocity:core version.

cd ..
meteor

Publishing to Meteor Package System

Make code changes
Commit changes
Update History.md with summary of changes
Bump version numbers in package.js, History.md and yuidoc.json
Execute yuidoc command from velocity root path
Commit changes
meteor publish
Tag last commit with the new version X.X.X
Push to github. Also push the new tag! (git push --tags)

We have to publish velocity:core for the different architectures (Mac OS, 64-bit Linux and 32-bit Linux). This is how it is done:

# Publish new version
meteor publish

# Open Mac build machine
meteor admine get-machine os.osx.x86_64
# Build on the machine
meteor publish-for-arch velocity:core@<VERSION>
# Login
# Exit
exit

# Open Linux build machine
meteor admine get-machine os.linux.x86_64
# Build on the machine (this will build a version for 64-bit and 32-bit Linux)
meteor publish-for-arch velocity:core@<VERSION>
# Login
# Exit
exit

The build for your own architecture can also be done on the own machine. But the publish-for-arch command for your architecture is still required.

Meteor Method Naming Convention

We have two naming schemas:

When the method does something with a resource type: velocity/<RESOURCE_NAME>/<ACTION>
When the method isn't specific to a resource type: velocity/<ACTION>

All parts are camelCase and start with a lowercase letter.

##Contributors

We are collaborating with an all-star team on unifying the Meteor testing landscape:

Sam Hatoum from Xolv.io, author of The Meteor Testing Manual
Adrian Lanning from Share911, contributor to all things Meteor
Mike Risse from MadEye, author of mocha-web
Ronen Babayoff from LaVaina Inc, co-author of Munit
Abigail Watson from Pentasyllabic, author of Meteor Cookbook, Selenium-Nightwatch
Robert Dickert from Meteor Boulder, contributor to all things Meteor
Josh Owens from Differential, author of Testing with Meteor
Jonas Aschenbrenner, velocity contributor, Jasmine package

Please join our discussions at the velocity-core google group.

Roadmap

https://trello.com/b/VCmaj73b/velocity-project

cramhead / velocity Goto Github PK

velocity's Introduction