docs(samples): add samples for IN, NOT_IN, and != operators.

[jlara310]

docs: add samples for IN, NOT_IN, and != operators.

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:

• Make sure to open an issue as a bug/issue before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
• Ensure the tests and linter pass
• Code coverage does not decrease (if any source code was changed)
• Appropriate docs were updated (if necessary)

Fixes #311 🦕

[snippet-bot]

Here is the summary of changes.

You are about to add 4 region tags.

• samples/snippets/snippets.py:21, tag datastore_size_coloration_query
• samples/snippets/snippets.py:33, tag datastore_in_query
• samples/snippets/snippets.py:42, tag datastore_not_equals_query
• samples/snippets/snippets.py:51, tag datastore_not_in_query

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[jlara310]

Depends on #287

[jlara310]

Now that #287 merged, this is ready for review/merge, too.

[jlara310]

The project used for testing requires the indexes in samples/index.yaml. Can someone help me add that index to the testing project?

gcloud datastore create index.yaml

[Mariatta]

Ok looks like the samples tests are now running, and there are some errors.

[jlara310]

I saw errors like this one for the unit tests:

details = "Datastore-Native databases do not support IN filters. Upgrade to Datastore-Mode to enable this."

Looks like the testing project is on the legacy Cloud Datastore backend. The new query features are only available for Firestore in Datastore mode. I'm not sure how to resolve this without creating a new testing project.

[jlara310]

Looks like it's just python-docs-samples-tests that is on the legacy back-end. The build-specific projects look to be on Firestore in Datastore mode. Opting into those in the noxfile to use them for testing.

The other projects will also require the new index:

python-docs-samples-tests-py36
python-docs-samples-tests-py37
python-docs-samples-tests-py38
python-docs-samples-tests-py39
python-docs-samples-tests-310

indexes:

• kind: Task
  properties:
  • name: tag
  • name: tag

[jlara310]

Added a test fixture to set up the required index if it doesn't already exist. However, I'm now getting this error when attempting to create that index:

"google.api_core.exceptions.PermissionDenied: 403 The caller does not have permission"

Either I didn't set things up quite right or the service account doesn't have index creation permissions on the build-specific test projects.

[jlara310]

I removed the snippets that require an index for now. I'd like to submit the remaining snippets as that will allow me to update the documentation. I can figure out the other two snippets in a follow-up PR.

I'm still failing two checks, but I'm not sure why. Any insights appreciated.

Kokoro — Build failed error:

nox > * docs: failed

Kokoro Prerelease Dependencies error:

ERROR collecting samples/snippets/snippets_test.py
Traceback:
/usr/local/lib/python3.8/importlib/init.py:127: in import_module
return _bootstrap._gcd_import(name[level:], package, level)
samples/snippets/snippets_test.py:16: in
import backoff
E ModuleNotFoundError: No module named 'backoff'

[jlara310]

PR should be good to go and ready to merge. Thank you.

[Mariatta]

Just wondering what is the purpose of the prints here?

One of the output is for the pprint:

pprint
<google.cloud.datastore.client.Client object at 0x1096a7820>
None

Perhaps we don't need these prints?

[Mariatta]

The pre-release dependencies CI is not needed so it's good to merge. Thank you!