Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.debian.maint.python > #16001

Review of package dep-logic

Path csiph.com!weretis.net!feeder8.news.weretis.net!news.samoylyk.net!gothmog.csi.it!bofh.it!news.nic.it!robomod
From Louis-Philippe Véronneau <pollo@debian.org>
Newsgroups linux.debian.maint.python
Subject Review of package dep-logic
Date Thu, 04 Jul 2024 04:00:01 +0200
Message-ID <IWjVn-7vTO-3@gated-at.bofh.it> (permalink)
X-Original-To eevel.weezel@gmail.com
X-Mailbox-Line From debian-python-request@lists.debian.org Thu Jul 4 01:53:12 2024
Old-Return-Path <pollo@debian.org>
X-Amavis-Spam-Status No, score=-113.22 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, BODY_8BITS=1.5, DKIMWL_WL_HIGH=-0.211, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, LDO_WHITELIST=-5, PGPSIGNATURE=-5, RCVD_IN_DNSWL_MED=-2.3, UNPARSEABLE_RELAY=0.001, USER_IN_DKIM_WELCOMELIST=-0.01, USER_IN_DKIM_WHITELIST=-100] autolearn=ham autolearn_force=no
MIME-Version 1.0
User-Agent Mozilla Thunderbird
Content-Language en-US
Autocrypt addr=pollo@debian.org; keydata= xjMEYEPdjBYJKwYBBAHaRw8BAQdA5yh8SOHhcvKeX/A4rv0/JTCL8Kgnnwy4/okKh1Htbs3N LExvdWlzLVBoaWxpcHBlIFbDqXJvbm5lYXUgPHBvbGxvQGRlYmlhbi5vcmc+wpYEExYKAD4C GwMFCwkIBwMFFQoJCAsFFgIDAQACHgECF4AWIQT2TWHTIfPLSJFWdT3h5UV8i61BEwUCZb/f iAUJDuIDfAAKCRDh5UV8i61BEzdaAP0cGJp8CpkywzefhdaJjfK5/uAQLRg5Bk6yCWnyR8B4 wQEAxA4C39PJPsosgOVBMdfkzCPhGVynYBnujOyEcksX1w/OOARgQ+DlEgorBgEEAZdVAQUB AQdAgRLbDfS/6GLXd15qI9zHso9UwJQgDbme7pvL1Z9rkG4DAQgHwn4EGBYKACYCGwwWIQT2 TWHTIfPLSJFWdT3h5UV8i61BEwUCZb/fsAUJDuIASgAKCRDh5UV8i61BEwYaAQDhvbQQqmTD F/fdodzfiY45IWYckb9rCvKaVnfP6DOY9QEA/eeaEWmOq2NpOYpBesVjBZCLe8jKv1WPMfLL YOfDIAc=
Content-Type multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="------------kB68RtHD0Y0t06Z89o2Z6omF"
X-Debian-User pollo
X-Mailing-List <debian-python@lists.debian.org> archive/latest/22037
List-ID <debian-python.lists.debian.org>
List-URL <https://lists.debian.org/debian-python/>
List-Archive https://lists.debian.org/msgid-search/72317157-d79e-4b47-9b61-36f69122099e@debian.org
Approved robomod@news.nic.it
Lines 188
Organization linux.* mail to news gateway
Sender robomod@news.nic.it
X-Original-Cc debian-python <debian-python@lists.debian.org>
X-Original-Date Wed, 3 Jul 2024 21:52:48 -0400
X-Original-Message-ID <72317157-d79e-4b47-9b61-36f69122099e@debian.org>
Xref csiph.com linux.debian.maint.python:16001

Show key headers only | View raw


[Multipart message — attachments visible in raw view] - view raw

Hello!

Here's my review of the work you did for dep-logic. I'll try to be 
thorough. If something isn't clear, feel free to hit me up on IRC.

===================================================================
1. d/changelog:

The version number for your package isn't right. You currently only have 
the upstream version (0.2.0) and you forgot to add the Debian revision 
part. It should thus be "0.2.0-1", as it's the first Debian revision of 
this upstream version. You can find more info on this field here [1].

You also named the package "dep-log" instead of "dep-logic"

2. d/control:

* You have a "Maintainer" field (which is OK), but you also need an 
"Uploaders" field, listing humans.

* Your "Build-Depends" field is very incomplete. I would suggest you 
look at other packages in the Team to get some inspiration, but in 
addition to python3-packaging, I would expect it to depend on:

- debhelper-compat (the main "Debian building framework" in use)
- dh-python (the debhelper tool we use to build Python packages)
- python3-all (all the python version available in the archive)
- python3-pdm-backend (the build tool used for this package)

* Your "Description" field only has a short description. It also needs a 
long one.

3. d/copyright:

Your copyright file is not complete. This file is very important, as if 
it's not 100% right, your package will be rejected by the FTP masters 
when submitting it to the archive for the first time (the NEW queue).

I would recommend using some automated tools (I like 'decopy') to start 
the work, but it's always a good idea to manually double-check and fix 
errors.

4. d/format:

There is currently no such thing as a "3.0 (git)" format. The choices 
you have are listed here [2], but the right one is most probably "3.0 
(quilt)".

Not only this, but this file should be in a directory named "debian/source".

5. d/rules:

The only thing you're currently specifying in this file, is that you're 
using the debhelper framework. At a minimum, you'll need to tell it to 
use pybuild, the main Python build tool in Debian.
===================================================================

More generally, I doubt you tried to build this package, as fails to 
pretty quickly :)

I encourage you to take a few minutes to set up a clean build 
environment. In my opinion, sbuild is a good tool for this and the 
documentation on the Debian wiki is pretty good [3]. I suggest you 
follow the "Option 2: Automatic setup using 
sbuild-debian-developer-setup" setup process, as this tools pretty much 
does everything for you.

Once setup, the "magical" sbuild command I like to use is: "sbuild -A -s 
-d unstable --source-only-changes PACKAGE".

If you need inspiration from another package, I think this one is fairly 
straightforward and simple:

https://salsa.debian.org/python-team/packages/python-mpv

Cheers, and thanks for your contribution to Debian :)

-----------------------------------------------------------------------
[1]: 
https://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-version

[2]: https://www.debian.org/doc/manuals/maint-guide/dother.en.html#sourcef

[3]: https://wiki.debian.org/sbuild

-- 
   ⢀⣴⠾⠻⢶⣦⠀
   ⣾⠁⢠⠒⠀⣿⡁  Louis-Philippe Véronneau
   ⢿⡄⠘⠷⠚⠋   pollo@debian.org / veronneau.org
   ⠈⠳⣄

Back to linux.debian.maint.python | Previous | Next | Find similar | Unroll thread


Thread

Review of package dep-logic Louis-Philippe Véronneau <pollo@debian.org> - 2024-07-04 04:00 +0200

csiph-web