Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
One and Done is a tool for new contributors looking to help Mozilla. It allows them to easily browse tasks and find ways to contribute which match their skills.
JavaScript Python CSS HTML Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin Update peep to v2.4
docs Removed QA references
lib/product_details_json Revert "Removed the old hard-coded product details since it's in a su…
oneanddone Only add the verification form to the context if the task.must_be_ver…
requirements Bug 1182122 - Upgrade the version of Django that One and Done uses to…
.gitignore Update .gitignore with some extra file types to ignore
.travis.yml
LICENSE Remove some unnecessary playdoh files and add placeholder homepage.
MANIFEST.in More pythonic Playdoh layout: no top level __init__, no apps
README.md Removed references to QA
contribute.json Create contribute.json
deploy.sh Changes required for Stackato
manage.py Address review comments
newrelic.ini Remove playdoh and upgrade to Django 1.7
setup.py Remove playdoh and upgrade to Django 1.7
stackato.yml Move settings out of stackato.py and into base.py using config()

README.md

oneanddone

One and Done is written with Playdoh and Django.

If you're interested in helping us out, please read through the project wiki and reach out to us!

About the project:

Contribute to Mozilla - One task at a time, One day at a time.

One and Done gives users a wide variety of ways to contribute to Mozilla. You can pick an easy task that only takes a few minutes - or take on a bigger challenge. This includes working on manual testing, automation, bug verification, mobile testing and more. Tasks are from a variety of Mozilla teams - so you can get involved with Automation, Firefox OS, Desktop Firefox, Mozilla websites, Services, Thunderbird and more.

Development Setup

These instructions assume you have git, python, and pip installed. If you don't have pip installed, you can install it with easy_install pip.

  1. Start by getting the source:

    $ git clone --recursive git@github.com:mozilla/oneanddone.git
    $ cd oneanddone

    Note you may want to fork and clone the repo as described in the github docs if you are doing active development.

  2. Create a virtualenv for One and Done. Skip the first step if you already have virtualenv installed.

    $ pip install virtualenv
    $ virtualenv venv
    $ source venv/bin/activate
  3. Set up MySQL locally. The MySQL Installation Documentation explains how to do this.

  4. Create the initial empty database; make sure it's utf8:

    # Start the MySQL server
    $ mysql.server start
    # Once successfully started, log into the console
    # using your username and password
    $ mysql -uroot -p
    

    In the mysql console:

    CREATE DATABASE oneanddone 
    DEFAULT CHARACTER SET utf8 
    DEFAULT COLLATE utf8_general_ci;
    

    To run all parts of the application, you will eventually need to populate this empty database with some example data, especially Tasks. There are many ways to populate the database. The method you choose may depend on the kind of data you want to add.

    • Use the create/edit features of your local One and Done instance. For example sign in with an administrator account and go to the /tasks/create/ URL of the app to create Tasks.
    • Use the Django admin section of your local One and Done instance by going to the /admin URL -- this also relies on an admin account. You can define Task Teams here, for example.
    • Use an external tool like MySQL Workbench.
    • Ask another active developer for a mysqldump of their local database.
  5. Install the compiled and development requirements:

    $ pip install -r requirements/compiled.txt
    $ pip install -r requirements/dev.txt

    Note: On OS X (in particular 10.8.5, Xcode 5.1), you may encounter the following error: clang: error: unknown argument. '-mno-fused-madd'. Try running pip with the ARCHFLAGS environment variable set, as follows: ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future pip install -r requirements/compiled.txt

  6. Configure your local settings by copying oneanddone/settings/local.py-dist to oneanddone/settings/local.py and customizing the settings in it:

    $ cp oneanddone/settings/local.py-dist oneanddone/settings/local.py

    The file is commented to explain what each setting does and how to customize them. Here are some highlights:

    • If you are running this locally and not over HTTPS, uncomment SESSION_COOKIE_SECURE = False
    • The HMAC_KEYS dictionary should not be empty.
    • Provide a value for SECRET_KEY.
  7. Initialize your database structure:

    $ python manage.py syncdb

    If you are asked to create a superuser, do so. Don't worry if you miss this step: see the Users section below for more information.

Once finished, the syncdb command should produce a message about which models have been synced. At the bottom, the message will include something like this:

   Not synced (use migrations):
    - oneanddone.tasks
    - oneanddone.users
    - rest_framework.authtoken

This means that you must also run ./manage.py migrate [model] for each model that is not synced with syncdb. More information about South migrations is included under the Applying Migrations section below.

Users

Playdoh uses BrowserID, a.k.a. Mozilla Persona, for user authentication. To add users to your local database, simply sign into your local One and Done instance. You may want to use dummy email accounts as described in Mozilla's guide to testing Persona.

You need at least one superuser to be able to develop and test administrative features of the project. You can create as many superusers as you like with python manage.py createsuperuser. After that, sign into your local One and Done instance with the superuser's email address as usual.

Applying Migrations

We're using South to handle database migrations. To apply the migrations, run the following:

   $ ./manage.py migrate oneanddone.tasks && ./manage.py migrate oneanddone.users

If you make changes to an existing model, say oneanddone.tasks, you will need to regenerate the schema migration as follows:

   $ ./manage.py schemamigration oneanddone.tasks --auto

To generate a blank data migration:

   # ./manage.py datamigration [model] [data_migration_name]
   # Example:
   $ ./manage.py datamigration oneanddone.tasks task_data 

Then fill in the generated file with logic, fixtures, etc. You can then apply this migration as above with:

   $ ./manage.py migrate oneanddone.tasks

Running the Development Server

You can launch the development server like so:

$ python manage.py runserver

Running Unit Tests

You can run all the unit tests in verbose mode as follows:

$ python manage.py test -v 2

You can also run specific tests:

# All tests in tasks/tests/test_helpers module.
$ python manage.py test oneanddone.tasks.tests.test_helpers -v 2
# Just one test (PageUrlTests.test_basic)
$ python manage.py test oneanddone.tasks.tests.test_helpers:PageUrlTests.test_basic -v 2

REST API Support

There is a REST API support which enables:

  • Getting complete list of Tasks.
  • Getting details about a Task with a particular id.
  • Create and Delete Tasks with a particular id. The Task queries can be made by appending api/v1/task/ to the base url.

GET and DELETE queries example.

curl -X GET http://127.0.0.1:8000/api/v1/task/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'
curl -X GET http://127.0.0.1:8000/api/v1/task/1/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'
curl -X DELETE http://127.0.0.1:8000/api/v1/task/1/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'
  • Getting a complete list of Users.
  • Getting details about a User with a particular email.
  • Create and Delete Users with a particular email. The User queries can be made by appending api/v1/user/ to the base url.

GET and DELETE queries example.

curl -X GET http://127.0.0.1:8000/api/v1/user/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'
curl -X GET http://127.0.0.1:8000/api/v1/user/testuser@tesmail.com/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'
curl -X DELETE http://127.0.0.1:8000/api/v1/user/testuser@testmail.com/ -H 'Authorization: Token d81e33c57b2d9471f4d6849bab3cb233b3b30468'

The API uses a Token Authentication system.

Token used in examples above is just a sample and actual Tokens can be generated from the admin panel by going to Authtoken > Tokens.

Functional Tests

Functional (Selenium) tests for oneanddone are maintained by the Web QA team and can be found at oneanddone-tests.

License

This software is licensed under the Mozilla Public License v. 2.0. For more information, read the file LICENSE.

Something went wrong with that request. Please try again.