feat: add .contains and .contained_by operators to match JS client

[parrotmac]

This change fixes #99.

Specifically, this change enables a PostgREST cs.*** query that searches an Array, such as [{"foo": "bar"}]. This aim to to keep the same API as .cs/.cd, modeled after the JS library's implementations.

[codecov]

Codecov Report

Merging #100 (4337de7) into master (796687d) will increase coverage by 0.26%.
The diff coverage is 95.55%.

@@            Coverage Diff             @@
##           master     #100      +/-   ##
==========================================
+ Coverage   90.10%   90.37%   +0.26%     
==========================================
  Files          22       22              
  Lines         869      914      +45     
==========================================
+ Hits          783      826      +43     
- Misses         86       88       +2     

Impacted Files	Coverage Δ
postgrest_py/base_request_builder.py	76.92% <86.66%> (+0.87%)	⬆️
tests/_async/test_filter_request_builder.py	100.00% <100.00%> (ø)
tests/_sync/test_filter_request_builder.py	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 796687d...4337de7. Read the comment docs.

[leynier]

Hi @parrotmac, can you implement tests for the new filters? If you are busy I will do it soon and then we merge the pull request. Are you okay with that?

[parrotmac]

Hi @parrotmac, can you implement tests for the new filters? If you are busy I will do it soon and then we merge the pull request. Are you okay with that?

Hey! I'll see about adding tests but if you beat me to it feel free to add commits/merge whenever 🙂

[J0]

Thanks for the PR! It looks good to me -- think we just need tests

[parrotmac]

Hey! Just added a few tests. Let me know if we want anything changed!

[sourcery-ai]

Sourcery Code Quality Report

✅  Merging this PR will increase code quality in the affected files by 0.27%.

Quality metrics	Before	After	Change
Complexity	0.67 ⭐	0.72 ⭐	0.05 👎
Method Length	23.77 ⭐	24.31 ⭐	0.54 👎
Working memory	5.12 ⭐	4.96 ⭐	-0.16 👍
Quality	90.65% ⭐	90.92% ⭐	0.27% 👍

Other metrics	Before	After	Change
Lines	268	336	68

Changed files	Quality Before	Quality After	Quality Change
postgrest_py/base_request_builder.py	88.74% ⭐	87.87% ⭐	-0.87% 👎
tests/_async/test_filter_request_builder.py	97.41% ⭐	97.78% ⭐	0.37% 👍
tests/_sync/test_filter_request_builder.py	97.41% ⭐	97.78% ⭐	0.37% 👍

Here are some functions in these files that still need a tune-up:

File	Function	Complexity	Length	Working Memory	Quality	Recommendation

Legend and Explanation

The emojis denote the absolute quality of the code:

• ⭐ excellent
• 🙂 good
• 😞 poor
• ⛔ very poor

The 👍 and 👎 indicate whether the quality has improved or gotten worse with this pull request.

---

Please see our documentation here for details on how these metrics are calculated.

We are actively working on this report - lots more documentation and extra metrics to come!

Help us improve this quality report!

[J0]

LGTM

[leynier]

LGTM @parrotmac thanks for the contribution