Firestore: implement listen conformance

.circleci/config.yml

@@ -0,0 +1,40 @@
+---
+version: 2
+jobs:
+  build:
+    docker:
+      - image: gcr.io/cloud-devrel-public-resources/python:latest
+    steps:
+      - checkout
+      - run:
+          name: Add GitHub public key to known hosts
+          command: |
+            mkdir -p ~/.ssh/
+            if [[ ! -f ~/.ssh/known_hosts ]] || ! grep "github.com" ~/.ssh/known_hosts; then
+              echo "
+            github.com ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAq2A7hRGmdnm9tUDbO9IDSwBK6TbQa+PXYPCPy6rbTrTtw7PHkccKrpp0yVhp5HdEIcKr6pLlVDBfOLX9QUsyCOV0wzfjIJNlGEYsdlLJizHhbn2mUjvSAHQqZETYP81eFzLQNnPHt4EVVUh7VfDESU84KezmD5QlWpXLmvU31/yMf+Se8xhHTvKSCZIFImWwoG6mbUoWf9nzpIoaSjB+weqqUUmpaaasXVal72J+UX2B+2RPW3RcT0eOzQgqlJL3RKrTJvdsjE3JEAvGq3lGHSZXy28G3skua2SmVi/w4yCE6gbODqnTWlg7+wC604ydGXA8VJiS5ap43JXiUFFAaQ==
+              " >> ~/.ssh/known_hosts
+            fi
+      - run:
+          name: Make sure google-cloud setup.py is valid
+          command: |
+            nox -s lint_setup_py
+      - deploy:
+          name: Update the docs
+          command: nox -s docs
+      - deploy:
+          name: Push to PyPI (if this is a release tag).
+          command: test_utils/scripts/circleci/twine_upload.sh
+    working_directory: /var/code/gcp/
+
+deployment:
+  tag_build_for_cci2:
+    # 1.0 style config for tag builds workaround
+    # For context, see:
+    # - https://discuss.circleci.com/t/build-on-tag/9864/30
+    # - https://discuss.circleci.com/t/git-tag-deploys-in-2-0/9493/8
+    # - https://circleci.com/gh/keybits/circulate/58#config/containers/0
+    # See "test_utils/scripts/circleci/get_tagged_package.py" for info on REGEX
+    tag: /(([a-z]+)-)*([0-9]+)\.([0-9]+)\.([0-9]+)/
+    commands:
+      - true

.coveragerc

@@ -6,7 +6,8 @@ omit =
     */_generated/*.py
     # Packages in the "google.cloud" package that we don't own.
     */google/cloud/gapic/*
-fail_under = 100
+    */google/cloud/grpc/*
+    */google/cloud/proto/*
 show_missing = True
 exclude_lines =
     # Re-enable the standard pragma

.github/CODEOWNERS

@@ -0,0 +1,43 @@
+# Code owners file.
+# This file controls who is tagged for review for any given pull request.
+
+# Chris Wilcox is the default owner for anything not explicitly
+# taken by someone else.
+*                         @crwilcox
+
+# Danny Hermes is the primary author of the original core library, as
+# well as most of the testing code. He is (currently) handling the
+# rewrite of `ndb`.
+core/*                    @dhermes
+test_utils/*              @dhermes
+ndb/*                     @dhermes
+
+# Thea Flowers is the author of the new google.api_core library.
+api_core/*                @theacodes
+docs/core/*               @theacodes
+
+# Tim Swast and Alix Hamilton share responsibility for BigQuery.
+bigquery/*                @tswast @alixhami
+
+# Danny Hermes and Tres Seaver co-authored the BigTable library.
+bigtable/*                @dhermes @tseaver
+
+# Danny Hermes is the primary maintainer of the Datastore library.
+datastore/*               @dhermes
+
+# Bill Prin is the primary maintainer of the Stackdriver libraries.
+error_reporting/*         @waprin
+monitoring/*              @waprin @supriyagarg @rimey
+logging/*                 @waprin @tseaver
+
+# Danny Hermes is the primary author of resource manager
+resourcemanager/*         @dhermes
+
+# Tim Swast is the primary author of Runtime Config.
+runtimeconfig/*           @tswast
+
+# Vikas Kedia is the product owner and Tres Seaver the author for Spanner.
+spanner/*                 @vkedia @tseaver
+
+# Doug Greiman and Angela Li are the owners of trace.
+trace/*                   @liyanhui1228 @duggelz

.github/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# How to Contribute
+
+We'd love to accept your patches and contributions to this project. There are
+just a few small guidelines you need to follow.
+
+## Contributor License Agreement
+
+Contributions to this project must be accompanied by a Contributor License
+Agreement. You (or your employer) retain the copyright to your contribution;
+this simply gives us permission to use and redistribute your contributions as
+part of the project. Head over to <https://cla.developers.google.com/> to see
+your current agreements on file or to sign a new one.
+
+You generally only need to submit a CLA once, so if you've already submitted one
+(even if it was for a different project), you probably don't need to do it
+again.
+
+## Code reviews
+
+All submissions, including submissions by project members, require review. We
+use GitHub pull requests for this purpose. Consult
+[GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
+information on using pull requests.
+
+## Community Guidelines
+
+This project follows [Google's Open Source Community
+Guidelines](https://opensource.google.com/conduct/).

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+Thanks for stopping by to let us know something could be better!
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.
+
+Please run down the following list and make sure you've tried the usual "quick fixes":
+
+  - Search the issues already opened: https://github.com/googleapis/google-cloud-python/issues
+  - Check for answers on StackOverflow: http://stackoverflow.com/questions/tagged/google-cloud-python
+
+If you are still having issues, please be sure to include as much information as possible:
+
+#### Environment details
+
+1. Specify the API at the beginning of the title (for example, "BigQuery: ...")
+   General, Core, and Other are also allowed as types
+2. OS type and version
+3. Python version and virtual environment information: `python --version`
+4. google-cloud-<service> version:  `pip show google-<service>` or `pip freeze`
+
+#### Steps to reproduce
+
+  1. ?
+
+#### Code example
+
+```python
+# example
+```
+
+#### Stack trace
+```
+# example
+```
+
+Making sure to follow these steps will guarantee the quickest resolution possible.
+
+Thanks!

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature request
+about: Suggest an idea for this library
+
+---
+
+Thanks for stopping by to let us know something could be better!
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.
+
+ **Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+ **Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+ **Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+ **Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/support_request.md

@@ -0,0 +1,7 @@
+---
+name: Support request
+about: If you have a support contract with Google, please create an issue in the Google Cloud Support console.
+
+---
+
+**PLEASE READ**: If you have a support contract with Google, please create an issue in the [support console](https://cloud.google.com/support/) instead of filing on GitHub. This will ensure a timely response.

.gitignore

@@ -25,8 +25,11 @@ pip-log.txt
 
 # Unit test / coverage reports
 .coverage
+.nox
 .tox
 .cache
+.pytest_cache
+htmlcov
 
 # Translations
 *.mo
@@ -42,8 +45,13 @@ pip-log.txt
 # JetBrains
 .idea
 
+# VS Code
+.vscode
+
 # Built documentation
 docs/_build
+docs/_build_doc2dash
+bigquery/docs/generated
 
 # Virtual environment
 env/
@@ -53,10 +61,12 @@ coverage.xml
 system_tests/local_test_setup
 
 # Make sure a generated file isn't accidentally committed.
-scripts/pylintrc_reduced
+pylintrc
+pylintrc.test
 
 # Directories used for creating generated PB2 files
 generated_python/
 cloud-bigtable-client/
 googleapis-pb/
 grpc_python_venv/
+pytype_output/

.kokoro/build-docs.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+
+set -eo pipefail
+
+cd ${KOKORO_ARTIFACTS_DIR}/github/google-cloud-python
+pwd
+ls
+env
+
+# Kokoro currently uses 3.6.1
+pyenv global 3.6.1
+
+# Kokoro exposes this as a file, but the scripts expect just a plain variable.
+export GITHUB_TOKEN=$(cat ${KOKORO_GFILE_DIR}/${GITHUB_TOKEN_FILE})
+
+# Add github to known hosts.
+ssh-keyscan github.com >> ~/.ssh/known_hosts
+
+# Activate the ssh key for dpebot. This is used to clone
+# repositories using the ssh:// protocol.
+eval `ssh-agent -s`
+chmod 600 ${KOKORO_GFILE_DIR}/id_rsa
+ssh-add ${KOKORO_GFILE_DIR}/id_rsa
+
+# Install Requirements
+pip install --upgrade -r docs/requirements.txt
+
+# Build and Publish Documentation
+bash test_utils/scripts/update_docs.sh kokoro

.kokoro/build.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# Copyright 2018 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+set -eo pipefail
+
+cd github/google-cloud-python
+
+# Disable buffering, so that the logs stream through.
+export PYTHONUNBUFFERED=1
+
+# Debug: show build environment
+env | grep KOKORO
+
+# Setup firestore account credentials
+export FIRESTORE_APPLICATION_CREDENTIALS=${KOKORO_GFILE_DIR}/firebase-credentials.json
+
+# Setup service account credentials.
+export GOOGLE_APPLICATION_CREDENTIALS=${KOKORO_GFILE_DIR}/service-account.json
+
+# Setup project id.
+export PROJECT_ID=$(cat "${KOKORO_GFILE_DIR}/project-id.json")
+
+# Find out if this package was modified.
+# Temporarily use Thea's fork of ci-diff-helper w/ Kokoro support.
+python3.6 -m pip install --quiet git+https://github.com/theacodes/ci-diff-helper.git
+python3.6 test_utils/scripts/get_target_packages_kokoro.py > ~/target_packages
+cat ~/target_packages
+
+if [[ ! -n $(grep -x "$PACKAGE" ~/target_packages) ]]; then
+    echo "$PACKAGE was not modified, returning."
+    exit;
+fi
+
+cd "$PACKAGE"
+
+# Remove old nox
+python3.6 -m pip uninstall --yes --quiet nox-automation
+
+# Install nox
+python3.6 -m pip install --upgrade --quiet nox
+python3.6 -m nox --version
+
+python3.6 -m nox

.kokoro/continuous/api_core.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "api_core"
+}

.kokoro/continuous/asset.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "asset"
+}

.kokoro/continuous/automl.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "automl"
+}

.kokoro/continuous/bigquery.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery"
+}

.kokoro/continuous/bigquery_datatransfer.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_datatransfer"
+}

.kokoro/continuous/bigquery_storage.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigquery_storage"
+}

.kokoro/continuous/bigtable.cfg

@@ -0,0 +1,7 @@
+# Format: //devtools/kokoro/config/proto/build.proto
+
+# Tell the trampoline which build file to use.
+env_vars: {
+    key: "PACKAGE"
+    value: "bigtable"
+}