Skip to content
This is a sandbox repo for writing test cases in markdown+cucumber and sync to MozTrap
Python Shell JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
apps
testcases
tests/mozilluminate
.gitignore
.gitmodules
.travis.yml
README.md
commit.py
commit.sh
testcases_locations.txt

README.md

MozIlluminate Build Status

This repo is an example of MozIlluminate, our next-generation test case management system for Firefox OS QA

#What is MozIlluminate? MozIlluminate allows you to write test cases in Google spreadsheet, and automatically check-in to GitHub, then automatically sync to MozTrap. So you get the best of both worlds, namely:

  • Easy to read/edit/search with Google spreadsheet
  • Version control with GitHub
  • Test execution and reporting from MozTrap

#Prerequisite

  • Use Linux or Mac OSX
  • Install python and pip
  • sudo pip install oauth2client gspread openpyxl
    • If the installation failed on OSX due to the six package deprecation, run the command with flag --ignore-installed six

#Usage

  1. Write your test cases in Google Spreadsheet (example)
  2. Clone this repository
  3. Ask the admin to give you commit permission to this repository
  4. Ask the admin to give you a credential JSON file, put it in the root directory of this repository
  5. Add the link of the spreadsheet to testcases_locations.txt
  6. Share the spreadsheet with this robot user: ci-458@mozilluminate-1160.iam.gserviceaccount.com
  7. Edit the spreadsheet as you like
  8. When you are done editing, run the commit.sh script, you'll be prompted to type a commit message, your github username and password
  9. Once the script finished without error, Go to https://travis-ci.org/MozIlluminate/mozilluminate-demo/builds to see the test cases being synced to MozTrap-dev
  10. Go to https://moztrap-dev.allizom.org/manage/cases/ to see your new test cases.

How it works

  • When you run commit.sh, the script downloads the google spreadsheet and transform it into a local json file
  • Then the commit.sh script does git add, git commit and git push
  • Travis CI server detects the push, and run the .travis.yml file
  • The .travis.yml file triggers the tests/MozIlluminate/sync.py
  • tests/MozIlluminate/sync.py checks for the diff between HEAD and HEAD~1 and push the difference to MozTrap throught its REST API

Admins

Known Issues

  • Tags don't work write now, blocked by https://github.com/mozilla/moztrap/pull/101
  • Product Version is hard-coded to v2.5.
  • Only supports one suite per test case (the spreadsheet name).
  • Environments are not handled
  • All test case steps goes into the first step on MozTrap, need to define a test step format.
You can’t perform that action at this time.