chango.git/django/contrib/postgres/fields/array.py, branch main

Fixed #36727 -- Deprecated Field.get_placeholder in favor of get_placeholder_sql.

2026-03-13T00:01:02Z

The lack of ability of the get_placeholder call chain to return SQL and parameters separated so they can be mogrified by the backend at execution time forced implementations to dangerously interpolate potentially user controlled values. The get_placeholder_sql name was chosen due to its proximity to the previous method, but other options such as Field.as_sql were considered but ultimately rejected due to its different input signature compared to Expression.as_sql that might have lead to confusion. There is a lot of overlap between what Field.get_db_prep_value and get_placeholder_sql do but folding the latter in the former would require changing its return signature to return expression which is a way more invasive change than what is proposed here. Given we always call get_db_prep_value it might still be an avenue worth exploring in the future to offer a publicly documented interface to allow field to take an active part in the compilation chain. Thanks Jacob for the review.

Refs #31055 -- Adjusted passing of Field.check kwargs to ArrayField.base_field.

2025-11-13T09:28:59Z

This was missed when Field.check(databases) was introduced.

Refs #35381 -- Delegated ArrayField element prepping to base_field.get_db_prep_save.

2025-10-29T19:00:52Z

Previously, ArrayField always used base_field.get_db_prep_value when saving, which could differ from how base_field prepares data for save. This change overrides ArrayField.get_db_prep_save to delegate to the base_field's get_db_prep_save, ensuring elements like None in JSONField arrays are saved correctly as SQL NULL instead of JSON null.

Replaced multi-level relative imports with absolute imports in django/.

2025-10-13T21:27:07Z

Fixed #32770 -- Added system check to ensure django.contrib.postgres is installed when using its features.

2025-06-18T06:36:49Z

Added postgres.E005 to validate 'django.contrib.postgres' is in INSTALLED_APPS when using: * PostgreSQL-specific fields (ArrayField, HStoreField, range fields, SearchVectorField), * PostgreSQL indexes (PostgresIndex and all subclasses), and * ExclusionConstraint The check provides immediate feedback during system checks rather than failing later with obscure runtime and database errors. Thanks to Simon Charette and Sarah Boyce for reviews.

Fixed #36276 -- Omitted size=None from ArrayField.deconstruct().

2025-03-25T11:02:14Z

Removed stray comment in ArrayField.check().

2025-01-03T16:10:24Z

Fixed #35944 -- Handled serialization of Unicode values in ArrayField and HStoreField.

2024-12-05T14:31:50Z

Fixed #29049 -- Added slicing notation to F expressions.

2023-12-30T07:24:30Z

Co-authored-by: Priyansh Saxena Co-authored-by: Niclas Olofsson Co-authored-by: David Smith Co-authored-by: Mariusz Felisiak Co-authored-by: Abhinav Yadav

Fixed #34285 -- Fixed index/slice lookups on filtered aggregates with ArrayField.

2023-02-07T12:16:41Z

Thanks Simon Charette for the review.