#25611: Use a common descriptor signature
------------------------------------------------+------------------------
               Reporter:  timgraham             |          Owner:  nobody
                   Type:  Cleanup/optimization  |         Status:  new
              Component:  Core (Other)          |        Version:  master
               Severity:  Normal                |       Keywords:
           Triage Stage:  Accepted              |      Has patch:  0
    Needs documentation:  0                     |    Needs tests:  0
Patch needs improvement:  0                     |  Easy pickings:  0
                  UI/UX:  0                     |
------------------------------------------------+------------------------
 Currently we have [https://github.com/django/django/pull/5226 several
 different signatures] for descriptor methods `__get__()` and `__set__()`:

 Curtis proposed:

 * "instance_type" is explicit
 * "cls" is a common convention for passing a class
 * "owner" is in the docs {but so are others}
 * and "type" I think is a bit confusing...

 So... my preference, upon reflection, would be: `def __get__(self,
 instance, cls=None)`

 This got several +1s [https://groups.google.com/forum/#!topic/django-
 developers/3eSHhZUzxv4 on the mailing list].

--
Ticket URL: <https://code.djangoproject.com/ticket/25611>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/052.5b8c5fd15dc0642b509322bb0d44bc1d%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to