Add pipeline snippets for Firestore

[morganchen12]

No description provided.

[daniel-sanche]

suggestion: Python lets you break up large numbers, so you could do 100_000 for readability (and consider this for other large numbers in this file)

[morganchen12]

Done here and throughout

[daniel-sanche]

We also have an async version of everything.

Often, we re-write the samples for both sync and async, and show both options in the language selection pickers. I'm not sure how you want to handle that here.

Maybe a couple samples for pipeline_initialization_async and basic_read_async is enough to show it exists, since the API is almost identical. Or maybe samples for async aren't needed for preview

[morganchen12]

I will try to get to the async versions after Java and if I don't get to it by launch day it'll just be a follow-on.

[daniel-sanche]

It would be great if we could have a test file that exercises these functions. Even just running them without verifying outputs would be helpful to make sure no exceptions are thrown, but reading back results would be ideal

It looks like the other samples in this repo aren't tested though, so maybe that would be too much to set up

[morganchen12]

Will defer to another PR

[daniel-sanche]

If you want to get rid of all the \, IIRC think you could do something like this:

results = (
    client.pipeline()
    .collection("books")
    .aggregate(
        Field.of("rating").average().as_("avg_rating"),
        groups=[Field.of("genre")]
    ).execute()
)

(But test it first)

[daniel-sanche]

Consider adding more imports for Vector, and others that may be missing through the file

But overall LGTM

[morganchen12]

After adding the snippets for expressions and inputs, I'm getting these errors:

(.venv) morganchen-mac:firebase-admin-python morganchen$ ./lint.sh 
Running linter on snippets/firestore/firestore_pipelines.py
************* Module snippets.firestore.firestore_pipelines
snippets/firestore/firestore_pipelines.py:1770:20: E1101: Module 'firebase_admin.firestore' has no 'SERVER_TIMESTAMP' member (no-member)
snippets/firestore/firestore_pipelines.py:2009:41: E1101: Class 'Expression' has no 'array' member (no-member)
snippets/firestore/firestore_pipelines.py:2010:16: E1101: Class 'Expression' has no 'array' member (no-member)
snippets/firestore/firestore_pipelines.py:2288:12: E1101: Instance of 'Field' has no 'array_get' member (no-member)

For the errors:

1. I'm not sure why I'm getting this error, it seems to be invoked correctly based on our docs
2. I'm also not sure why I'm getting this error since Array is documented here
3. See 2
4. The array_get method seems to just be missing from the Python SDK. @daniel-sanche this is likely me not reading something somewhere, but just in case it was overlooked

[daniel-sanche]

1. One of those is from google.cloud import firestore, and the other is from firebase_admin import firestore. I'm not super familiar with the firebase_admin wrapper, but I don't think those are fully equivalent

2. In the end, I think Array was actually implemented as a stand-alone class:

from google.cloud.firestore_v1.pipeline_expressions import Array
Array(["bar", Field.of("baz")])

It looks like there's an out-dated docstring. I can fix that.

Let me know if you think it's important to have array exposed on Expression as well though. I removed it in an effort to keep the API surface manageable, instead of exposing multiple ways of expressing the same thing. But I can add it back if that's more consistent with other languages.

4. array_get was a late addition, but it should be in the preview branch as of yesterday. Maybe try running again