paypal / nemo-docs Goto Github PK

Documentation for the Nemo automation framework

License: Other

nemo-docs's Introduction

Welcome to Nemo

Nemo is a framework and set of conventions for automated testing of web and even native applications. How you use it is only limited by your imagination. A common starting point is to pair Nemo with a task runner (e.g. Grunt) and a test runner (e.g. Mocha). But if you have a different task and test runner, Nemo will work with that as well.

Get a grounding in selenium-webdriver Promises and Control Flow

Meet the players

The following modules are essential for getting started with Nemo

generator-nemo

To get everything off the ground quickly, start here.

nemo

Nemo lovingly hugs selenium-webdriver, bundles up the plugins of your choice, and gives it all back to you in a single namespace for your testing pleasure.

nemo-view

Nemo view replaces nemo's built-in "view" functionality with a much cooler interface. Use it in concert with nemo-drivex and nemo-locatex.

Try the sample app

Follow the README instructions to get the sample app installed and run Nemo tests.

Selenium Webdriver Docs

The selenium-webdriver instance is exposed via nemo.driver, so it helps to know the API that you have access to.

nemo-docs's People

Contributors

Stargazers

Watchers

nemo-docs's Issues

Update README links

Hi,

the upgrade readme links are not valid any more. There is no develop 1.0 branch.

Best Regards
K.Ostrowski

add saucelabs section to integrations.md

headless chrome info

Was playing with headless chrome. this works:

"driver": {
    "builders": {
      "withCapabilities": [{
        "browserName": "chrome",
        "chromeOptions": {
          "binary": "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary",
          "args": ["headless","window-size=1200,800", "ignore-certificate-errors", "disable-gpu"]
        }
      }]
    }
  },

add faq for minimal gulp setup

answer:

var gulp = require('gulp'),
    env = require('gulp-env'),
    mocha = require('gulp-mocha');

gulp.task('test:browser', function () {
    env.set({
        nemoBaseDir: path.resolve(__dirname, 'test/functional'),
        USER_EMAIL: '[email protected]',
        USER_PW: '1010'
    });
    return gulp.src('test/functional/spec/*.js', {read: false})
        .pipe(mocha({reporter: 'spec', timeout: 60000}));
});

nemo-cor@1 (formerly nemo)

selenium@3 support (async/await, no promise manager, headless chrome support)
nemo-view@3 with destructure support

nemo (formerly nemo-runner)

single dependency (nemo will require nemo-cor and nemo-view)
profiles configuration
test runner
- wraps programmatic mocha.js
- injects configured nemo instance (this.nemo)
- includes nemo-view plugin automatically (nemo.view is the project-supported "page" abstraction)
- automatic screenshots (afterEach, and programmatic (nemo.runner.snap())
- parallel runs (by file, data, grep, profile)
debug easily (single process)
historical reporting (influxdb)
- configure external (future: automatic local if not configured)
- each mocha test run associated to
  - date/time
  - tags (uuid[, grep, profile, file, key, custom])
  - test run configuration
- data also associates parent runs/parallel runs
graphQL/RESTful interface (WIP)
- deploy as a service (docker image to cloud server) or run locally
- query historical data
- manage configuration/test assets
- kickoff test runner

Release and Support

important plugins updated (see #19)
docs needed
examples needed
website update needed
screencast training needed
RESTful interface features
RESTful interface UI

Update docs for the FF support in Selenium 3

Outdated links

Links in the page : https://github.com/paypal/nemo-docs/blob/1.0-develop/plugins.md are outdated and leads to 404. Can you please fix it.