Split dialect from driver, part 3: Swap in SQLAlchemy dialect and tests

Move SQLAlchemy dialect implementation to the top level.

Author: amotl

.github/workflows/tests.yml

@@ -24,8 +24,8 @@ jobs:
         sqla-version: ['<1.4', '<1.5', '<2.1']
         pip-allow-prerelease: ['false']
 
-        # To save resources, only use the most recent Python versions on macOS.
         exclude:
+          # To save resources, only use the most recent Python versions on macOS.
           - os: 'macos-latest'
             python-version: '3.7'
           - os: 'macos-latest'
@@ -34,6 +34,13 @@ jobs:
             python-version: '3.9'
           - os: 'macos-latest'
             python-version: '3.10'
+          # SQLAlchemy 1.3 is not supported on Python 3.12 and higher.
+          - os: 'ubuntu-latest'
+            python-version: '3.12'
+            sqla-version: '<1.4'
+          - os: 'macos-latest'
+            python-version: '3.12'
+            sqla-version: '<1.4'
 
         # Another CI test matrix slot to test against prerelease versions of Python packages.
         include:

README.md

@@ -21,7 +21,7 @@ library [crate-python].
 The package is available from [PyPI] at [sqlalchemy-cratedb]. 
 To install the most recent version, run:
 ```shell
-pip install --upgrade cratedb-sqlalchemy
+pip install --upgrade sqlalchemy-cratedb
 ```
 
 ## Documentation and help

backlog.md

@@ -0,0 +1,12 @@
+# Backlog
+
+## Iteration +1
+From dialect split-off.
+- Re-enable parameterized test cases.
+  ```
+  tests.addTest(ParametrizedTestCase.parametrize(SqlAlchemyCompilerTest, param={"server_version_info": None}))
+  tests.addTest(ParametrizedTestCase.parametrize(SqlAlchemyCompilerTest, param={"server_version_info": (4, 0, 12)}))
+  tests.addTest(ParametrizedTestCase.parametrize(SqlAlchemyCompilerTest, param={"server_version_info": (4, 1, 10)}))
+  ```
+- Re-enable doctests.
+

pyproject.toml

@@ -119,6 +119,8 @@ changelog = "https://github.com/crate-workbench/sqlalchemy-cratedb/blob/main/CHA
 documentation = "https://github.com/crate-workbench/sqlalchemy-cratedb"
 homepage = "https://github.com/crate-workbench/sqlalchemy-cratedb"
 repository = "https://github.com/crate-workbench/sqlalchemy-cratedb"
+[project.entry-points."sqlalchemy.dialects"]
+crate = "sqlalchemy_cratedb:CrateDialect"
 
 [tool.black]
 line-length = 80