chore(migration): Migrate code from googleapis/gapic-generator-python into packages/gapic-generator

packages/gapic-generator/.bazeliskrc

@@ -0,0 +1,2 @@
+# See https://github.com/bazelbuild/bazelisk
+USE_BAZEL_VERSION=6.5.0

packages/gapic-generator/.bazelrc

@@ -0,0 +1,2 @@
+# New protobuf requires C++17
+build --repo_env=BAZEL_CXXOPTS="-std=c++17"

packages/gapic-generator/.coveragerc

@@ -0,0 +1,20 @@
+[run]
+branch = True
+omit =
+  gapic/cli/*.py
+  *_pb2.py
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Enable an English version.
+    Impossible; skip coverage checks.
+    # Ignore debug-only repr
+    def __repr__
+    # Abstract methods by definition are not invoked
+    @abstractmethod
+    @abc.abstractmethod
+

packages/gapic-generator/.dockerignore

@@ -0,0 +1,57 @@
+# Version control scaffolding
+.git
+.gitignore
+
+# Python scaffolding
+*.py[cod]
+*.egg
+*.egg-info
+dist
+build
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.nox
+.tox
+.cache
+.pytest_cache
+htmlcov
+
+# Translations
+*.mo
+
+# Mac
+.DS_Store
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# JetBrains
+.idea
+
+# Built documentation
+docs/_build
+docs/_build_doc2dash
+
+# Virtual environment
+env/
+coverage.xml
+
+# Make sure a generated file isn't accidentally committed.
+pylintrc
+pylintrc.test

packages/gapic-generator/.flake8

@@ -0,0 +1,44 @@
+[flake8]
+ignore =
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E123, E124
+  # Closing bracket mismatches opening bracket's line.
+  # This works poorly with type annotations in method declarations.
+  E123, E124
+  # Line over-indented for visual indent.
+  # This works poorly with type annotations in method declarations.
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E126, E128, E131
+  E126, E128, E131
+  # Line break after binary operator.
+  # This catches line breaks after "and" / "or" as a means of breaking up
+  # long if statements, which PEP 8 explicitly encourages.
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): W504
+  W504
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E203
+  E203
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E501
+  E501
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E712
+  E712
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E711
+  E711
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E722
+  E722
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): E741
+  E741
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): F401
+  F401
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): F541
+  F541
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): F841
+  F841
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): F811
+  F811
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): W503
+  W503
+  # TODO(https://github.com/googleapis/gapic-generator-python/issues/2333): W291
+  W291
+exclude =
+  # Exclude golden files
+  tests/integration
+  # Exclude generated protobuf code
+  *_pb2.py

packages/gapic-generator/.githooks/pre-commit

@@ -0,0 +1,133 @@
+#!/bin/sh
+
+# Copyright 2021 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.
+
+# Pre-commit Git checks.
+# Set up:
+#  ln -s .githooks/pre-commit .git/hooks/pre-commit
+
+# Constants.
+BOLD="\e[1m"
+UNSET="\e[0m"
+WHITE="\e[97m"
+RED="\e[91m"
+BACK_MAGENTA="\e[45m"
+BACK_BLUE="\e[44m"
+BACK_RED="\e[41m"
+BACK_GREEN="\e[42m"
+
+# Methods.
+function echo_error {
+  ERR_MSG=$1
+  HELP_MSG=$2
+  echo -e "$BOLD $BACK_BLUE $WHITE Precommit:\t $BACK_RED Changes NOT committed. $UNSET"
+  echo -e "$BOLD $BACK_BLUE $WHITE Precommit:\t $BACK_RED $WHITE $ERR_MSG $BACK_BLUE $HELP_MSG $UNSET"
+}
+
+function echo_status {
+  STATUS_MSG=$1
+  echo -e "$BOLD $BACK_BLUE $WHITE Precommit:\t $STATUS_MSG $UNSET"
+}
+
+function echo_success {
+  echo -e "$BOLD $BACK_BLUE $WHITE Precommit:\t $BACK_GREEN $WHITE SUCCESS. $UNSET All checks passed!"
+}
+
+function header_check_preparation {
+  echo_status "Setting up license check environment"
+  export GOPATH=$(go env GOPATH)
+  if [ $? -ne 0 ];
+  then
+      echo_status "Please install Go first, instructions can be found here: https://golang.org/doc/install."
+  else
+      export ENV_PATH=$(echo $PATH)
+      if [[ $ENV_PATH != *$GOPATH* ]];
+      then
+        echo_status "GOPATH is not in the system path, adding it now."
+        export PATH=$GOPATH/bin:$PATH
+      fi
+      which addlicense
+      if [ $? -ne 0 ];
+      then
+        echo_status "addlicense tool is not yet installed, downloading it now."
+        go get -u github.com/google/addlicense
+      fi
+  fi
+}
+
+# Disk cache.
+BAZEL_CACHE_DIR=/tmp/bazel_cache_gapic_generator_java
+if [ ! -d $BAZEL_CACHE_DIR ]
+then
+  mkdir $BAZEL_CACHE_DIR
+fi
+
+# Check only the staged files.
+NUM_TOTAL_FILES_CHANGED=$(git diff --cached --name-only | wc -l)
+NUM_PYTHON_FILES_CHANGED=$(git diff --cached --name-only "*.py" | wc -l)
+NUM_UNIT_GOLDEN_FILES_CHANGED=$(git diff --cached --name-only "src/test/*/*.golden" | wc -l)
+NUM_INTEGRATION_GOLDEN_FILES_CHANGED=$(git diff --cached --name-only "tests/integration/goldens/*/*.golden" | wc -l)
+NUM_INTEGRATION_BAZEL_FILES_CHANGED=$(git diff --cached --name-only "tests/integration/*/BUILD.bazel" | wc -l)
+NUM_BAZEL_FILES_CHANGED=$(git diff --cached --name-only "*BUILD.bazel" | wc -l)
+
+if [ $NUM_TOTAL_FILES_CHANGED -le 0 ]
+then
+  echo_error "No new files to commit." ""
+  exit 1
+fi
+
+
+if [ -x /usr/lib/git-core/google_hook ]; then
+  /usr/lib/git-core/google_hook pre-commit "$@"
+fi
+
+# Check unit tests.
+if [ $NUM_PYTHON_FILES_CHANGED -gt 0 ] || [ $NUM_UNIT_GOLDEN_FILES_CHANGED -gt 0 ]
+then
+  echo_status "Checking unit tests..."
+  nox -s unit-3.9
+  TEST_STATUS=$?
+  if [ $TEST_STATUS != 0 ]
+  then
+    echo_error "Tests failed." "Please fix them and try again."
+    exit 1
+  fi
+fi
+
+# Check integration tests.
+if [ $NUM_PYTHON_FILES_CHANGED -gt 0 ] \
+  || [ $NUM_INTEGRATION_GOLDEN_FILES_CHANGED -gt 0 ] \
+  || [ $NUM_INTEGRATION_BAZEL_FILES_CHANGED -gt 0 ]
+then
+  echo_status "Checking integration tests..."
+  bazel --batch test --disk_cache="$BAZEL_CACHE_DIR" //tests/integration/...
+  TEST_STATUS=$?
+  if [ $TEST_STATUS != 0 ]
+  then
+    echo_error "Tests failed." "Please fix them and try again."
+    exit 1
+  fi
+fi
+
+# Check and fix Bazel format.
+if [ $NUM_BAZEL_FILES_CHANGED -gt 0 ]
+then
+  for FILE in $(find ./ -name BUILD.bazel)
+  do
+    buildifier --lint=fix $FILE
+  done
+fi
+
+echo_success

packages/gapic-generator/.gitignore

@@ -0,0 +1,74 @@
+*.py[cod]
+*.sw[op]
+
+# Bazel
+bazel-*
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.nox
+.tox
+.cache
+.pytest_cache
+htmlcov
+
+# Translations
+*.mo
+
+# Mac
+.DS_Store
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# JetBrains
+.idea
+
+# VS Code
+.vscode
+
+# Built documentation
+docs/_build
+docs/_build_doc2dash
+
+# Virtual environment
+env/
+coverage.xml
+
+# Make sure a generated file isn't accidentally committed.
+pylintrc
+pylintrc.test
+
+# Mypy
+.mypy_cache
+
+# pyenv
+.python-version
+
+# Test dependencies and output
+api-common-protos
+tests/snippetgen/.test_output

packages/gapic-generator/.librarian/state.yaml

@@ -0,0 +1,11 @@
+image: us-central1-docker.pkg.dev/cloud-sdk-librarian-prod/images-prod/python-librarian-generator@sha256:68c7c79adf43af1be4c0527673342dd180aebebf652ea623614eaebff924ca27
+libraries:
+  - id: gapic-generator
+    version: 1.30.13
+    last_generated_commit: ""
+    apis: []
+    source_roots:
+      - .
+    preserve_regex: []
+    remove_regex: []
+    tag_format: v{version}

packages/gapic-generator/.readthedocs.yml

@@ -0,0 +1,6 @@
+---
+build:
+  image: latest
+python:
+  pip_install: true
+  version: 3.7

packages/gapic-generator/.repo-metadata.json

@@ -0,0 +1,14 @@
+{
+    "name": "gapic-generator",
+    "name_pretty": "Google API Client Generator for Python",
+    "client_documentation": "https://gapic-generator-python.readthedocs.io/en/stable/",
+    "product_documentation": "",
+    "issue_tracker": "https://github.com/googleapis/gapic-generator-python/issues",
+    "release_level": "stable",
+    "language": "python",
+    "library_type": "CORE",
+    "repo": "googleapis/gapic-generator-python",
+    "distribution_name": "gapic-generator",
+    "default_version": "",
+    "codeowner_team": "@googleapis/cloud-sdk-python-team"
+}