Cavy

Cavy is a cross-platform, integration test framework for React Native, by
Pixie Labs.

Cavy tests allow you to programmatically interact with deeply nested components
within your application. Write your tests in pure JavaScript and run them on
both Android and iOS.

Cavy tests look like this:

export default function(spec) {
  spec.describe('A list of the employees', function() {
    spec.it('can be filtered by search input', async function() {
      await spec.exists('EmployeeList.JimCavy');
      await spec.fillIn('SearchBar.TextInput', 'Amy');
      await spec.press('Button.FilterSubmit');
      await spec.notExists('EmployeeList.JimCavy');
      await spec.exists('EmployeeList.AmyTaylor');
    });
  });
}

📋 Requirements

• React Native >= 0.59
• React >= 16.8.0

👶 Getting started

Get set up with Cavy by following our
installation guide.

You might also want to
check out some articles and watch talks about Cavy to
find out a bit more before you write code.

If you need some inspiration, head over to Cavy’s
sample app, follow the
instructions in the README, and see Cavy in action.

📘 Documentation

Full documentation and guides for Cavy can be found on our
website.

🗺️ Development roadmap

Take a look at our public
Pivotal Tracker to see what
we’re currently working on, and what features we plan to add to Cavy next.

💯 Contributing

When making changes to Cavy, it’s useful to have the
CavyTester app running in
development for regression testing.

Follow the instructions it’s own README on how to get the tester app running
against a local version of the Cavy library.

Here you’ll also find instructions on adding new test cases to ensure
your functionality is fully tested. Please do this 😃

Before contributing, please read the code of conduct.

• Check out the latest master to make sure the feature hasn’t been implemented
  or the bug hasn’t been fixed yet.
• Check out the issue tracker to make sure someone already hasn’t requested it
  and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Remember to
  submit a PR to DefinitelyTyped
  to update the type definitions if you’ve changed a function’s inputs or outputs.
• Remember to submit a PR to update
  the documentation if you’ve changed
  how something works.
• Please try not to mess with the package.json, version, or history. If you
  want to have your own version, or is otherwise necessary, that is fine, but
  please isolate to its own commit so we can cherry-pick around it.