Skip to content

Latest commit

 

History

History
112 lines (89 loc) · 4.2 KB

CONTRIBUTING.md

File metadata and controls

112 lines (89 loc) · 4.2 KB

Contributing

  1. Please sign one of the contributor license agreements below.
  2. Fork the repo, develop and test your code changes, add docs.
  3. Make sure that your commit messages clearly describe the changes.
  4. Send a pull request.

Here are some guidelines for hacking on oauth2client.

Using a Development Checkout

You’ll have to create a development environment to hack on oauth2client, using a Git checkout:

  • While logged into your GitHub account, navigate to the oauth2client repo on GitHub.

  • Fork and clone the oauth2client repository to your GitHub account by clicking the "Fork" button.

  • Clone your fork of oauth2client from your GitHub account to your local computer, substituting your account username and specifying the destination as hack-on-oauth2client. For example:

    $ cd ${HOME}
$ git clone [email protected]:USERNAME/oauth2client.git hack-on-oauth2client
$ cd hack-on-oauth2client
$ # Configure remotes such that you can pull changes from the oauth2client
$ # repository into your local repository.
$ git remote add upstream https://github.com:google/oauth2client
$ # fetch and merge changes from upstream into master
$ git fetch upstream
$ git merge upstream/master

Now your local repo is set up such that you will push changes to your GitHub repo, from which you can submit a pull request.

  • Create a virtualenv in which to install oauth2client:

    $ cd ~/hack-on-oauth2client
$ virtualenv -ppython2.7 env

    Note that very old versions of virtualenv (virtualenv versions below, say, 1.10 or thereabouts) require you to pass a --no-site-packages flag to get a completely isolated environment.

    You can choose which Python version you want to use by passing a -p flag to virtualenv. For example, virtualenv -ppython2.7 chooses the Python 2.7 interpreter to be installed.

    From here on in within these instructions, the ~/hack-on-oauth2client/env virtual environment you created above will be referred to as $VENV. To use the instructions in the steps that follow literally, use the export VENV=~/hack-on-oauth2client/env command.

  • Install oauth2client from the checkout into the virtualenv using setup.py develop. Running setup.py develop must be done while the current working directory is the oauth2client checkout directory:

    $ cd ~/hack-on-oauth2client
$ $VENV/bin/python setup.py develop

Running Tests

  • To run all tests for oauth2client on a single Python version, run nosetests from your development virtualenv (See Using a Development Checkout above).

  • To run the full set of oauth2client tests on all platforms, install tox into a system Python. The tox console script will be installed into the scripts location for that Python. While in the oauth2client checkout root directory (it contains tox.ini), invoke the tox console script. This will read the tox.ini file and execute the tests on multiple Python versions and platforms; while it runs, it creates a virtualenv for each version/platform combination. For example:

    $ sudo pip install tox
$ cd ~/hack-on-oauth2client
$ tox

Contributor License Agreements

Before we can accept your pull requests you'll need to sign a Contributor License Agreement (CLA):

  • If you are an individual writing original source code and you own the intellectual property, then you'll need to sign an individual CLA.
  • If you work for a company that wants to allow you to contribute your work, then you'll need to sign a corporate CLA.

You can sign these electronically (just scroll to the bottom). After that, we'll be able to accept your pull requests.