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:4e3486fee9eba44b75a18c67f0c60fa0c4af675132305e3ff3fae2e9b94f94bb
+libraries:
+ - id: gapic-generator
+ version: 1.30.0
+ 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/actools-python"
+}