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/python-polyfactory.git
    cd python-polyfactory
    gbp buildpackage --git-pbuilder


Missing packages to build -doc package fully equal
--------------------------------------------------

We can build a -doc package at the moment but some additional packages will
be needed to get it packaged for Debian and the packaged version of the
documentation can become fully equal to the upstream documentation on

  https://polyfactory.litestar.dev

Most of the missing parts are patched out by a patch queue.

src:git-cliff https://github.com/orhun/git-cliff
src:litestar-sphinx-theme https://github.com/litestar-org/litestar-sphinx-theme
    (Currently replaced by python3-sphinx-rtd-theme)
src:shibuya https://github.com/lepture/shibuya
    (ITP https://bugs.debian.org/1079090)
src:sphinx-togglebutton https://github.com/executablebooks/sphinx-togglebutton


Removed Links to external graphics in the -doc package
------------------------------------------------------

Upstream uses linking to external image resources for the logos of the sponsors
in docs/index.rst.
To prevent potential privacy breaches by these external links the linking got
removed. The used logo for Scalar is included within the -doc package as the
license can assumed to be Expat for the logo.

The logos for the companies Stok and Telemetry Sports can't be provided locally
from within the package. The license of these graphics is unclear and could
not find on the their web pages.

The logo for Stok (https://www.stok.kr/info), which is a PNG file, is
originally pointing to:
https://avatars.githubusercontent.com/u/144093421

For the company Telemetry Sports upstream is using this file for the logo:
https://raw.githubusercontent.com/litestar-org/branding/main/assets/sponsors/telemetry-sports/unofficial-telemetry-whitebg.svg
Also here the license isn't clear, the SVG file isn't providing any license
information.


 -- Carsten Schoenert <c.schoenert@t-online.de>  Thu, 02 Jan 2025 16:00:00 +0200
