chore(migration): Migrate code from googleapis/python-spanner-sqlalchemy into packages/sqlalchemy-spanner

packages/sqlalchemy-spanner/.gitignore

@@ -0,0 +1,64 @@
+*.py[cod]
+*.sw[op]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+.eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.nox
+.cache
+.pytest_cache
+
+
+# Mac
+.DS_Store
+
+# JetBrains
+.idea
+
+# VS Code
+.vscode
+
+# emacs
+*~
+
+# Built documentation
+docs/_build
+docs.metadata
+
+# Virtual environment
+.venv/
+env/
+coverage.xml
+sponge_log.xml
+
+# System test environment variables.
+system_tests/local_test_setup
+
+# Make sure a generated file isn't accidentally committed.
+pylintrc
+pylintrc.test
+
+test.cfg
+database

packages/sqlalchemy-spanner/.librarian/state.yaml

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

packages/sqlalchemy-spanner/.repo-metadata.json

@@ -0,0 +1,14 @@
+{
+    "name": "sqlalchemy-spanner",
+    "name_pretty": "Spanner dialect for SQLAlchemy",
+    "product_documentation": "https://cloud.google.com/spanner/docs",
+    "client_documentation": "https://github.com/googleapis/python-spanner-sqlalchemy",
+    "issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
+    "release_level": "stable",
+    "language": "python",
+    "library_type": "INTEGRATION",
+    "repo": "googleapis/python-spanner-sqlalchemy",
+    "distribution_name": "sqlalchemy-spanner",
+    "requires_billing": true,
+    "api_shortname": "sqlalchemy-spanner"
+}

packages/sqlalchemy-spanner/BENCHMARKS.md

@@ -0,0 +1,26 @@
+# Benchmarks
+
+The performance test suite is located in [test/benchmark.py](https://github.com/cloudspannerecosystem/python-spanner-sqlalchemy/blob/main/test/benchmark.py) and intended to compare execution time difference between SQLAlchemy dialect for Spanner and pure Spanner client.
+
+The test suite requirements:
+- `scipy` Python package installed
+- the original dialect requirements
+
+Use `PROJECT`, `INSTANCE` and `DATABASE` module constants to set a project to execute tests on.
+
+The following measurements were made on a VM instance.
+
+# 25-11-2021
+
+|Test|mean, sec|error|std_dev|
+|----|-------|-----|--------|
+|SPANNER insert_one_row_with_fetch_after| 0.16|0.0|0.03|
+|ALCHEMY insert_one_row_with_fetch_after|  0.11| 0.0|0.02|
+|SPANNER read_one_row| 0.04| 0.0| 0.01|
+|ALCHEMY read_one_row| 0.01| 0.0| 0.0|
+|SPANNER insert_many_rows|  0.33| 0.01| 0.05|
+|ALCHEMY insert_many_rows|  0.32| 0.01| 0.06|
+|SPANNER select_many_rows| 0.04| 0.0| 0.01|
+|ALCHEMY select_many_rows|   0.03| 0.0| 0.0|
+|SPANNER insert_many_rows_with_mutations| 0.07| 0.0| 0.03|
+|SQLALCHEMY insert_many_rows_with_mutations| 0.31| 0.01| 0.07|

packages/sqlalchemy-spanner/CODE_OF_CONDUCT.md

@@ -0,0 +1,43 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project,
+and in the interest of fostering an open and welcoming community,
+we pledge to respect all people who contribute through reporting issues,
+posting feature requests, updating documentation,
+submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project
+a harassment-free experience for everyone,
+regardless of level of experience, gender, gender identity and expression,
+sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information,
+such as physical or electronic
+addresses, without explicit permission
+* Other unethical or unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct.
+By adopting this Code of Conduct,
+project maintainers commit themselves to fairly and consistently
+applying these principles to every aspect of managing this project.
+Project maintainers who do not follow or enforce the Code of Conduct
+may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported by opening an issue
+or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.2.0,
+available at [http://contributor-covenant.org/version/1/2/0/](http://contributor-covenant.org/version/1/2/0/)

packages/sqlalchemy-spanner/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# 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/conduct/).
+
+## Running tests
+
+SQLAlchemy Spanner dialect includes a test suite, which can be executed both on a live service and Spanner emulator.
+
+**Using pytest**
+To execute the test suite with standard `pytest` package you only need to checkout to the package folder and run:
+```
+pytest -v
+```
+
+**Using nox**
+The package includes a configuration file for `nox` package, which allows to execute the dialect test suite in an isolated virtual environment. To execute all the `nox` sessions checkout to the dialect folder and then run command:
+```
+nox
+```
+To execute only the dialect compliance test suite execute command:
+```
+nox -s compliance_test
+```
+
+**Live service**
+To run the test suite on a live service use [setup.cfg](https://github.com/cloudspannerecosystem/python-spanner-sqlalchemy/blob/main/setup.cfg) `db.default` attribute to set URI of the project, instance and database, where the tests should be executed.
+
+**Emulator**
+As the dialect is built on top of the Spanner DB API, it also supports running on Spanner emulator. To make it happen you need to set an environment variable, pointing to the emulator service, for example `SPANNER_EMULATOR_HOST=localhost:9010`