Add quering references

[dirkkul]

Usage:

result = client.query.get(
  "Article", ["title", "url", "wordCount", Reference(reference_property="inPublication", linked_class="Publication", properties=["name", "founded_in"]
            )]
     )

which is equivalent to

result = client.query.get(
  "Article", ["title", "url", "wordCount", 
     "inPublication {... on Publication {name founded_in}}"]
     )

For nested requests it looks like this:

client.query.get(
        "D",
        [
            "nonRef",
            Reference(
                reference_property="refC",
                linked_class="C",
                properties=[
                    "nonRef",
                    Reference(
                        reference_property="refB",
                        linked_class="B",
                        properties=[
                            "nonRef",
                            Reference(
                                reference_property="refA", linked_class="A", properties=["nonRef"]
                            ),
                        ],
                    ),
                ],
            ),
            Reference(
                reference_property="refB",
                linked_class="B",
                properties=[
                    "nonRef",
                    Reference(reference_property="refA", linked_class="A", properties=["nonRef"]),
                ],
            ),
        ],
    ).do()

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.02 🎉

Comparison is base (7dfdd9b) 96.49% compared to head (04098c4) 96.52%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #284      +/-   ##
==========================================
+ Coverage   96.49%   96.52%   +0.02%     
==========================================
  Files          64       64              
  Lines        7653     7707      +54     
==========================================
+ Hits         7385     7439      +54     
  Misses        268      268              

Impacted Files	Coverage Δ
integration/test_crud.py	100.00% <100.00%> (ø)
test/gql/test_get.py	100.00% <100.00%> (ø)
weaviate/gql/get.py	99.63% <100.00%> (+0.01%)	⬆️
weaviate/gql/query.py	100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.