This package is maintained with git-buildpackage(1). It follows DEP-14 for
branch naming (e.g. using debian/master for the current version in Debian
unstable due Debian Python team policy).

It uses pristine-tar(1) to store enough information in git to generate bit
identical tarballs when building the package without having downloaded an
upstream tarball first.

When working with patches it is recommended to use "gbp pq import" to import
the patches, modify the source and then use "gbp pq export --commit" to commit
the modifications.

The changelog is generated using "gbp dch" so if you submit any changes don't
bother to add changelog entries but rather provide a nice git commit message
that can then end up in the changelog.

It is recommended to build the package with pbuilder using:

    gbp buildpackage --git-pbuilder

For information on how to set up a pbuilder environment see the git-pbuilder(1)
manpage. In short:

    DIST=sid git-pbuilder create
    gbp clone https://salsa.debian.org/python-team/packages/djangorestframework.git
    cd djangorestframework
    gbp buildpackage --git-pbuilder


Additinal notes for packaging
#############################

The upstream project updating from time to time to include a newer JQuery
minimized version. This requires the existence of the same minimized version
in the folder debian/missing-sources.

You can get the minimized version from

https://releases.jquery.com/jquery/

Upstream has no dependency set on the tz package, but is including this in
rest_framework/fields.py line 33ff

32 ...
33 try:
34     import pytz
35 except ImportError:
36     pytz = None
37 ...

In Debian we did add a manual dependency on python3-pytz so beside the exception
catching users should not experience some strange side effects due a potential
missing tz library.

See also https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1013742

 -- Carsten Schoenert <c.schoenert@t-online.de>  Sun, 23 Mar 2024 12:00:00 +0100
