Implement __contains, __contained_by, __overlap and __len for ArrayField

[henadzit]

Description

Implements the following lookup types for ArrayField:

• contains - await ArrayFields.filter(array__contains=[1, 2, 3]).first() which will use the @> operator
• contained_by - will use the <@ operator
• overlap - will use the && operator
• len - will use the array_length function, e.g. await ArrayFields.filter(array__len=3).first()

Motivation and Context

This should close #1857 and #370.

The filters are modeled after Django's counterparts.

How Has This Been Tested?

make ci

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added the changelog accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• All new and existing tests passed.

[codspeed-hq]

CodSpeed Performance Report

Merging #1877 will not alter performance

_{Comparing henadzit:feat/array-filters (3cccc75) with develop (0898c2b)}

Summary

✅ 16 untouched benchmarks

[henadzit]

The psycopg tests are failing with

psycopg.errors.UndefinedFunction: operator does not exist: integer[] <@ smallint[]
LINE 1: SELECT "array" "0" FROM "arrayfields" WHERE "array"<@$1

because psycopg is trying to use the smallest type possible... I need to think how to overcome this.

[henadzit]

The psycopg tests are failing with

psycopg.errors.UndefinedFunction: operator does not exist: integer[] <@ smallint[]
LINE 1: SELECT "array" "0" FROM "arrayfields" WHERE "array"<@$1

because psycopg is trying to use the smallest type possible... I need to think how to overcome this.

Fixed!

[coveralls]

Pull Request Test Coverage Report for Build 13367452752

Details

• 53 of 60 (88.33%) changed or added relevant lines in 5 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage decreased (-0.002%) to 89.424%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
tortoise/filters.py	24	31	77.42%

Totals
Change from base Build 13362403703:	-0.002%
Covered Lines:	6527
Relevant Lines:	7123

---

💛 - Coveralls

[waketzheng]

I think that if field is not None is better.

[henadzit]

updated

[henadzit]

Removed the internal notes that important only for the development process, not for the package users.