#37142: Document and move django.utils.deprecation.django_file_prefixes
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Type:
| Cleanup/optimization
Status: new | Component: Utilities
Version: dev | Severity: Normal
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
I'm preparing a documentation section "Writing your own fetch mode" as
suggested in a
[https://github.com/django/django/pull/17554#discussion_r2345545473 review
of the feature].
Emitting a warning rather than an exception is the most obvious simple use
case. I'd like my example to skip over Django frames when emitting the
warning, just like we do for deprecations. So, I'd like to import and use
`django_file_prefixes()` for this.
But:
- it's not documented (except for the contributing documentation, see
9932866e3a7693930a90a924014c10614820ea70)
- it lives in `.deprecation`
We have 4 +1s for moving it out of `.deprecation` in this
[https://github.com/django/django/pull/19887#discussion_r2373952228 review
thread].
I propose to move it and document it (outside the contributor
documentation), to make it public API.
--
Ticket URL: <https://code.djangoproject.com/ticket/37142>
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 [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/django-updates/0107019e933c826a-90dc13d1-823c-4f75-bbc3-903d6f5877c3-000000%40eu-central-1.amazonses.com.
