Django/django
11
0
Fork 0
Code Pull Requests Projects Releases Activity

[1.9.x] Fixed #26078 -- Clarified "old vs. new" in model._meta upgrade guide.

Browse Source 
Thanks Thomas Güttler for the suggestion.

Backport of 28acc0d6df844ccfc8de6f4e7d5883eb4841e946 from master
This commit is contained in:
Tim Graham 2016-01-14 07:24:25 -05:00
parent 16a52cff32
commit f619b72815
1 changed files with 11 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
docs/ref/models/meta.txt
View File

@ -172,7 +172,7 @@ that were previously excluded - will almost certainly result in better code.
Assuming you have a model named ``MyModel``, the following substitutions Assuming you have a model named ``MyModel``, the following substitutions
can be made to convert your code to the new API: can be made to convert your code to the new API:
* ``MyModel._meta.get_field(name)``:: * ``MyModel._meta.get_field(name)`` becomes::
f = MyModel._meta.get_field(name) f = MyModel._meta.get_field(name)
@ -185,10 +185,8 @@ can be made to convert your code to the new API:
``get_field()`` API will find ``get_field()`` API will find
:class:`~django.contrib.contenttypes.fields.GenericForeignKey` relations; :class:`~django.contrib.contenttypes.fields.GenericForeignKey` relations;
* ``MyModel._meta.get_field_by_name(name)``: * ``MyModel._meta.get_field_by_name(name)`` returns a tuple of these four
values with the following replacements:
``get_field_by_name()`` returned four values:
``(field, model, direct, m2m)``:
- ``field`` can be found by ``MyModel._meta.get_field(name)`` - ``field`` can be found by ``MyModel._meta.get_field(name)``
@ -206,7 +204,7 @@ can be made to convert your code to the new API:
- ``m2m`` can be found through the - ``m2m`` can be found through the
:attr:`~django.db.models.Field.many_to_many` attribute on the field. :attr:`~django.db.models.Field.many_to_many` attribute on the field.
* ``MyModel._meta.get_fields_with_model()``:: * ``MyModel._meta.get_fields_with_model()`` becomes::
[ [
(f, f.model if f.model != MyModel else None) (f, f.model if f.model != MyModel else None)
@ -216,7 +214,7 @@ can be made to convert your code to the new API:
or (f.many_to_one and f.related_model) or (f.many_to_one and f.related_model)
] ]
* ``MyModel._meta.get_concrete_fields_with_model()``:: * ``MyModel._meta.get_concrete_fields_with_model()`` becomes::
[ [
(f, f.model if f.model != MyModel else None) (f, f.model if f.model != MyModel else None)
@ -228,7 +226,7 @@ can be made to convert your code to the new API:
) )
] ]
* ``MyModel._meta.get_m2m_with_model()``:: * ``MyModel._meta.get_m2m_with_model()`` becomes::
[ [
(f, f.model if f.model != MyModel else None) (f, f.model if f.model != MyModel else None)
@ -236,14 +234,14 @@ can be made to convert your code to the new API:
if f.many_to_many and not f.auto_created if f.many_to_many and not f.auto_created
] ]
* ``MyModel._meta.get_all_related_objects()``:: * ``MyModel._meta.get_all_related_objects()`` becomes::
[ [
f for f in MyModel._meta.get_fields() f for f in MyModel._meta.get_fields()
if (f.one_to_many or f.one_to_one) and f.auto_created if (f.one_to_many or f.one_to_one) and f.auto_created
] ]
* ``MyModel._meta.get_all_related_objects_with_model()``:: * ``MyModel._meta.get_all_related_objects_with_model()`` becomes::
[ [
(f, f.model if f.model != MyModel else None) (f, f.model if f.model != MyModel else None)
@ -251,14 +249,14 @@ can be made to convert your code to the new API:
if (f.one_to_many or f.one_to_one) and f.auto_created if (f.one_to_many or f.one_to_one) and f.auto_created
] ]
* ``MyModel._meta.get_all_related_many_to_many_objects()``:: * ``MyModel._meta.get_all_related_many_to_many_objects()`` becomes::
[ [
f for f in MyModel._meta.get_fields(include_hidden=True) f for f in MyModel._meta.get_fields(include_hidden=True)
if f.many_to_many and f.auto_created if f.many_to_many and f.auto_created
] ]
* ``MyModel._meta.get_all_related_m2m_objects_with_model()``:: * ``MyModel._meta.get_all_related_m2m_objects_with_model()`` becomes::
[ [
(f, f.model if f.model != MyModel else None) (f, f.model if f.model != MyModel else None)
@ -266,7 +264,7 @@ can be made to convert your code to the new API:
if f.many_to_many and f.auto_created if f.many_to_many and f.auto_created
] ]
* ``MyModel._meta.get_all_field_names()``:: * ``MyModel._meta.get_all_field_names()`` becomes::
from itertools import chain from itertools import chain
list(set(chain.from_iterable( list(set(chain.from_iterable(