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 (1169390) with develop (1d4d60b)}

Summary

✅ 12 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.