chore(migration): Migrate code from googleapis/python-crc32c into packages/google-crc32c

packages/google-crc32c/.coveragerc

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2024 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.
+
+# Generated by synthtool. DO NOT EDIT!
+[run]
+branch = True
+omit =
+  google/__init__.py
+  google/cloud/__init__.py
+
+[report]
+fail_under = 100
+show_missing = True
+exclude_lines =
+    # Re-enable the standard pragma
+    pragma: NO COVER
+    # Ignore debug-only repr
+    def __repr__
+    # Ignore abstract methods
+    raise NotImplementedError
+omit =
+  */gapic/*.py
+  */proto/*.py
+  */core/*.py
+  */site-packages/*.py
+  google/cloud/__init__.py

packages/google-crc32c/.flake8

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2024 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.
+
+# Generated by synthtool. DO NOT EDIT!
+[flake8]
+ignore = E203, E231, E266, E501, W503
+exclude =
+  # Exclude generated code.
+  **/proto/**
+  **/gapic/**
+  **/services/**
+  **/types/**
+  *_pb2.py
+
+  # Standard linting exemptions.
+  **/.nox/**
+  __pycache__,
+  .git,
+  *.pyc,
+  conf.py

packages/google-crc32c/.gitignore

@@ -0,0 +1,105 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+usr/

packages/google-crc32c/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "crc32c"]
+	path = google_crc32c
+	url = https://github.com/google/crc32c

packages/google-crc32c/.librarian/state.yaml

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

packages/google-crc32c/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+# Copyright 2024 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
+#
+# http://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.
+#
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.0.1
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+-   repo: https://github.com/psf/black
+    rev: 23.7.0
+    hooks:
+    - id: black
+-   repo: https://github.com/pycqa/flake8
+    rev: 6.1.0
+    hooks:
+    - id: flake8

packages/google-crc32c/.repo-metadata.json

@@ -0,0 +1,14 @@
+{
+    "name": "google-crc32c",
+    "name_pretty": "A python wrapper of the C library 'Google CRC32C'",
+    "product_documentation": "",
+    "client_documentation": "https://github.com/googleapis/python-crc32c",
+    "issue_tracker": "https://github.com/googleapis/python-crc32c/issues",
+    "release_level": "stable",
+    "language": "python",
+    "library_type": "OTHER",
+    "repo": "googleapis/python-crc32c",
+    "distribution_name": "google-crc32c",
+    "default_version": "",
+    "codeowner_team": ""
+}

packages/google-crc32c/BUILDING.md

@@ -0,0 +1,92 @@
+
+# Building
+
+## Be sure to check out all submodules:
+
+```
+$ git clone --recursive https://github.com/googleapis/python-crc32c
+```
+
+## Building and Testing Wheels
+
+The scripts directory contains multiple scripts for building. They are also
+used by the CI workflows which can be found at .github/workflows.
+
+On Linux:
+
+```
+./scripts/manylinux/build.sh
+
+
+# Install the wheel that was built as a result
+pip install --no-index --find-links=wheels google-crc32c
+
+# Check the package, try and load the native library.
+python ./scripts/check_crc32c_extension.py
+```
+
+On OS X:
+
+```
+# Build the C library and wheel
+./scripts/osx/build.sh
+
+# Install the wheel that was built as a result
+pip install --no-index --find-links=wheels google-crc32c
+
+# Check the package, try and load the native library.
+python ./scripts/check_crc32c_extension.py
+```
+
+On Windows:
+
+```
+.\scripts\windows\build.bat
+.\scripts\windows\test.bat
+```
+
+
+## Installing locally for testing
+
+Initialize the submodules and build the main `libcrc32c.so` shared
+library using `cmake` / `make`:
+
+```bash
+$ cd python-crc32c
+$ git submodule update --init --recursive
+$ python -m venv venv
+$ venv/bin/pip install --upgrade setuptools pip wheel
+$ venv/bin/pip install cmake
+$ mkdir usr
+$ export CRC32C_INSTALL_PREFIX=$(pwd)/usr
+$ mkdir google_crc32c/build
+$ cd google_crc32c/build
+$ ../../venv/bin/cmake \
+>   -DCMAKE_BUILD_TYPE=Release \
+>   -DCRC32C_BUILD_TESTS=no \
+>   -DCRC32C_BUILD_BENCHMARKS=no \
+>   -DBUILD_SHARED_LIBS=yes \
+>   -DCMAKE_INSTALL_PREFIX:PATH=${CRC32C_INSTALL_PREFIX} \
+>   ..
+$ make all install
+$ cd ../..
+```
+
+Now, run the tests:
+
+```bash
+$ venv/bin/python setup.py build_ext \
+    --include-dirs=$(pwd)/usr/include \
+    --library-dirs=$(pwd)/usr/lib \
+    --rpath=$(pwd)/usr/lib
+$ venv/bin/pip install -e .[testing]
+$ venv/bin/py.test tests/
+============================= test session starts ==============================
+platform linux -- Python 3.6.7, pytest-3.10.0, py-1.7.0, pluggy-0.8.0
+rootdir: ..., inifile:
+collected 9 items
+
+tests/test___init__.py .........                                         [100%]
+
+=========================== 9 passed in 0.03 seconds ===========================
+```