Restructure the package (#92)

Author: liyanhui1228

.circleci/config.yml

@@ -29,12 +29,12 @@ jobs:
           command: |
             if [ -n "$GOOGLE_APPLICATION_CREDENTIALS" ]; then
               openssl aes-256-cbc -d -a -k "$GOOGLE_CREDENTIALS_PASSPHRASE" \
-                  -in trace/tests/system/credentials.json.enc \
-                  -out trace/$GOOGLE_APPLICATION_CREDENTIALS
+                  -in tests/system/trace/credentials.json.enc \
+                  -out $GOOGLE_APPLICATION_CREDENTIALS
             else
               echo "No credentials. System tests will not run."
             fi
       - run:
-          name: Run tests - opencensus.trace
+          name: Run tests - opencensus
           command: |
-            nox -f trace/nox.py
+            nox -f nox.py

trace/.coveragerc .coveragerctrace/.coveragerc renamed to .coveragerc

@@ -1,4 +1,4 @@
 setuptools >= 36.4.0
 sphinx >= 1.6.3
 
-trace/
+.

README.rst

@@ -12,9 +12,99 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import os
+from __future__ import absolute_import
 
 import nox
+import os
+
+
+@nox.session
+@nox.parametrize('py', ['2.7', '3.4', '3.5', '3.6'])
+def unit(session, py):
+    """Run the unit test suite."""
+
+    # Run unit tests against all supported versions of Python.
+    session.interpreter = 'python{}'.format(py)
+
+    # Install all test dependencies, then install this package in-place.
+    session.install('-r', 'requirements-test.txt')
+
+    session.install('-e', '.')
+
+    # Run py.test against the unit tests.
+    session.run(
+        'py.test',
+        '--quiet',
+        '--cov=opencensus.trace',
+        '--cov-append',
+        '--cov-config=.coveragerc',
+        '--cov-report=',
+        '--cov-fail-under=97',
+        'tests/unit/',
+        *session.posargs
+    )
+
+
+@nox.session
+@nox.parametrize('py', ['2.7', '3.6'])
+def system(session, py):
+    """Run the system test suite."""
+
+    # Sanity check: Only run system tests if the environment variable is set.
+    if not os.environ.get('GOOGLE_APPLICATION_CREDENTIALS', ''):
+        session.skip('Credentials must be set via environment variable.')
+
+    # Run the system tests against latest Python 2 and Python 3 only.
+    session.interpreter = 'python{}'.format(py)
+
+    # Set the virtualenv dirname.
+    session.virtualenv_dirname = 'sys-' + py
+
+    # Install all test dependencies, then install this package into the
+    # virutalenv's dist-packages.
+    session.install('-r', 'requirements-test.txt')
+    session.install('.')
+
+    # Run py.test against the system tests.
+    session.run(
+        'py.test',
+        '-s',
+        'tests/system/',
+        *session.posargs
+    )
+
+
+@nox.session
+def lint(session):
+    """Run flake8.
+    Returns a failure if flake8 finds linting errors or sufficiently
+    serious code quality issues.
+    """
+    session.interpreter = 'python3.6'
+    session.install('flake8')
+    session.install('.')
+    session.run('flake8', 'opencensus/trace')
+
+
+@nox.session
+def lint_setup_py(session):
+    """Verify that setup.py is valid (including RST check)."""
+    session.interpreter = 'python3.6'
+    session.install('docutils', 'pygments')
+    session.run(
+        'python', 'setup.py', 'check', '--restructuredtext', '--strict')
+
+
+@nox.session
+def cover(session):
+    """Run the final coverage report.
+    This outputs the coverage report aggregating coverage from the unit
+    test runs (not system test runs), and then erases coverage data.
+    """
+    session.interpreter = 'python3.6'
+    session.install('coverage', 'pytest-cov')
+    session.run('coverage', 'report', '--show-missing', '--fail-under=100')
+    session.run('coverage', 'erase')
 
 
 @nox.session
@@ -34,3 +124,4 @@ def docs(session):
     # Build the docs!
     session.run(
         'bash', os.path.join('.', 'scripts', 'update_docs.sh'))
+