v2.2.0a1

Features

• [WIP] The first stage of nox implementation (#468) (96f2223)
• add PyPI release support (#451) (da82c41), closes #449
• cursor must detect if the parent connection is closed (#463) (a9fd5a3)
• refactor connect() function, cover it with unit tests (#462) (4fedcf1)
• Stage 2 of nox implementation - adding docs target (#473) (45d6b97)
• Stage 3-4 of nox implementation - adding auto-format targets (#478) (59e7c3f)
• Stage 5 of nox implementation - adding coverage targets (#479) (cec6b96)
• Stage 6 of nox implementation - enabling system tests (#480) (dc73bf6)

Bug Fixes

• Change release script package name (#489) (388ea6b)
• Fix black, isort compatibility (#469) (dd005d5)
• update pypi package name (#454) (47154d1), closes #455
• Update README for alpha release (#503) (3d31167)
• Update version to 2.2.0a1 (#506) (a3a6344), closes #502

Reverts

• Revert "django_spanner: skip 57 expressions_case tests that assume serial pk" (48909f6), closes #353

Documentation

• minor fixes to README.md (#448) (f969000)
• move test suite information to CONTRIBUTING.md (#442) (05280ae)

Release v0.0.2

Features a fix for the version discrepancy from missing dependencies, as well as some documentation updates on how to run tests.

Alpha release

With this release tagged as Alpha, you can install django-spanner by following these 3 steps below:

1. Installing it

Please see installing it

Create a Cloud Spanner database

If you haven't already created a Cloud Spanner database, please do so by following this guide: https://cloud.google.com/spanner/docs/quickstart-console
Afterwards, please take note of the project-id, instance name, database name and application default credentials (ADCs).

2. Edit your settings.py file

DATABASES = {
    'default': {
        'ENGINE': 'django_spanner',
        'PROJECT': '<project_id>',
        'INSTANCE': '<instance_id>',
        'NAME': '<database_name>',
    },
}

Example
For example:

DATABASES = {
    'default': {
        'ENGINE': 'django_spanner',
        'PROJECT': 'appdev-soda-spanner-staging', # Or the GCP project-id
        'INSTANCE': 'django-dev1', # Or the Cloud Spanner instance
        'DATABASE': 'db1', # Or the Cloud Spanner database to use
    }
}

Run your application/migrations

Run your application and migrations as you normally would.

Fully fledged example

We've got some examples in https://github.com/googleapis/python-spanner-django/tree/master/examples and at the end of say running healthchecks.io, the migration should produce the following when viewed on the Cloud Spanner UI

Next steps

Please try it out, file/report bugs, provide feedback, share your shares, let us know what you think.
We are on the journey towards a Beta and then finally to General Availability someday. For now we'll keep working on improving it, ironing out bugs and fixing them as we go on.

Thank you.
Kind regards,
Django-Spanner team