#1125688 RFS: joystickwake/0.5.1 [ITP] -- joystick-aware screen waker

#1125688#5
Date:
2026-01-16 01:49:51 UTC
From:
To:
Dear mentors,

I am looking for a sponsor for my package "joystickwake":

 * Package name     : joystickwake
   Version          : 0.5.1
   Upstream contact : Forest <forestix@gaga.casa>
 * URL              : https://codeberg.org/forestix/joystickwake
 * License          : Expat
 * Vcs              : https://codeberg.org/forestix/joystickwake.git -b debian
   Section          : games

The source builds the following binary packages:

  joystickwake - joystick-aware screen waker

To access further information about this package, please visit the following URL:

https://mentors.debian.net/package/joystickwake/

Alternatively, you can download the package with 'dget' using this command:

  dget -x https://mentors.debian.net/debian/pool/main/j/joystickwake/joystickwake_0.5.1.dsc

Changes for the initial release:

 joystickwake (0.5.1) unstable; urgency=medium
 .
   * Initial Debian release. (Closes: #1125687)
   * Make setup script compatible with python 3.14.
   * Require python 3.8 or newer.
   * Use f-strings.
   * Use text encoding & context manager in open() calls.
   * Standards-Version: 4.7.2
   * Build-Depends: python3-setuptools

Regards,

Forest

#1125688#14
Date:
2026-05-30 18:51:39 UTC
From:
To:
As already discussed in the mentors reviews, this shouldn't be a native
package.

#1125688#23
Date:
2026-06-08 21:25:12 UTC
From:
To:
It's now a non-native package, uploaded to mentors.
(The policy docs don't sufficiently explain why this is a good idea,
IMHO, but discussion with Stephen Kitt convinced me.)

Still seeking a sponsor.

#1125688#30
Date:
2026-07-15 12:44:15 UTC
From:
To:
Hello,

This package mostly looks okay, but I'm not sure it should be in the games section. I'm thinking something like utils, but suggestions are welcome.

Here is my full Lintian output, in case you would like to do another pass. Please remove the moreinfo tag once you're ready for another review. Feel free to CC me, if I'm available I can take another look.

Running lintian...
N:
E: joystickwake: package-section-games-but-contains-no-game
N:
N:   This package is marked as part of the section games, but doesn't contain
N:   files in /usr/games. Binaries of games must be installed in /usr/games.
N:
N:   Please refer to Games (Section 11.11) in the Debian Policy Manual for
N:   details.
N:
N:   Visibility: error
N:   Show-Always: no
N:   Check: games
N:
N:
I: joystickwake source: older-debian-watch-file-standard 4 [debian/watch]
N:
N:   The version= line in the debian/watch file in this package declares an
N:   older version. Please upgrade when you have a chance.
N:
N:   Please refer to the uscan(1) manual page for details.
N:
N:   Visibility: info
N:   Show-Always: no
N:   Check: debian/watch/standard
N:
N:
I: joystickwake: package-installs-legacy-python-egg-info [usr/lib/python3/dist-packages/joystickwake-0.5.3.egg-info/PKG-INFO]
N:
N:   The package installs .egg-info directory. The modern replacement for
N:   .egg-info is .dist-info. That means the package was possibly built using
N:   the deprecated setup.py install mechanism. This should be usually
N:   converted to pybuild-plugin-pyproject.
N:
N:   Please refer to Bug#1121735,
N:   https://wiki.debian.org/Python/PybuildPluginPyproject, and
N:   https://setuptools.pypa.io/en/stable/history.html#setup-install-deprecation-note
N:   for details.
N:
N:   Visibility: info
N:   Show-Always: no
N:   Check: languages/python
N:
N:
I: joystickwake: package-installs-legacy-python-egg-info [usr/lib/python3/dist-packages/joystickwake-0.5.3.egg-info/]
N:
I: joystickwake: package-installs-legacy-python-egg-info [usr/lib/python3/dist-packages/joystickwake-0.5.3.egg-info/dependency_links.txt]
N:
I: joystickwake: package-installs-legacy-python-egg-info [usr/lib/python3/dist-packages/joystickwake-0.5.3.egg-info/requires.txt]
N:
I: joystickwake: package-installs-legacy-python-egg-info [usr/lib/python3/dist-packages/joystickwake-0.5.3.egg-info/top_level.txt]
N:
I: joystickwake source: uses-deprecated-python-stdlib distutils (deprecated in Python 3.10, removed in Python 3.12) [setup.py:13]
N:
N:
N:   The Python library flagged by this tag has been formally marked as
N:   deprecated.
N:
N:   Please prepare for this deprecation and migrate away from this Python
N:   library.
N:
N:   See-Also: https://peps.python.org/pep-0594/#deprecated-modules
N:
N:   Visibility: info
N:   Show-Always: no
N:   Check: languages/python/stdlib-deprecation
N:
N:
P: joystickwake source: package-uses-old-debhelper-compat-version 13
N:
N:   This package uses a debhelper compatibility level that is no longer
N:   recommended. Please consider using the recommended level.
N:
N:   For most packages, the best way to set the compatibility level is to
N:   specify debhelper-compat (= X) as a Build-Depends in debian/control. You
N:   can also use the debian/compat file or export DH_COMPAT in debian/rules.
N:
N:   If no level is selected debhelper defaults to level 1, which is
N:   deprecated.
N:
N:   Please refer to the debhelper(7) manual page for details.
N:
N:   Visibility: pedantic
N:   Show-Always: no
N:   Check: debhelper
N:
N:
P: joystickwake source: upstream-metadata-file-is-missing
N:
N:   This source package is not Debian-native but it does not have a
N:   debian/upstream/metadata file.
N:
N:   The Upstream MEtadata GAthered with YAml (UMEGAYA) project is an effort to
N:   collect meta-information about upstream projects from any source package.
N:   This file is in YAML format and it is used in to feed the data in the
N:   UltimateDebianDatabase. For example, it can contains the way the authors
N:   want their software be cited in publications and some bibliographic
N:   references about the software.
N:
N:   Please add a debian/upstream/metadata file.
N:
N:   Please refer to https://dep-team.pages.debian.net/deps/dep12/ and
N:   https://wiki.debian.org/UpstreamMetadata for details.
N:
N:   Visibility: pedantic
N:   Show-Always: no
N:   Check: debian/upstream/metadata
N:
N:
X: joystickwake source: debian-watch-does-not-check-openpgp-signature [debian/watch]
N:
N:   This watch file does not specify a means to verify the upstream tarball
N:   using a cryptographic signature.
N:
N:   If upstream distributions provides such signatures, please use the
N:   pgpsigurlmangle options in this watch file's opts= to generate the URL of
N:   an upstream OpenPGP signature. This signature is automatically downloaded
N:   and verified against a keyring stored in debian/upstream/signing-key.asc
N:
N:   Of course, not all upstreams provide such signatures but you could request
N:   them as a way of verifying that no third party has modified the code after
N:   its release (projects such as phpmyadmin, unrealircd, and proftpd have
N:   suffered from this kind of attack).
N:
N:   Please refer to the uscan(1) manual page for details.
N:
N:   Visibility: pedantic
N:   Show-Always: no
N:   Check: debian/watch
N:   Renamed from: debian-watch-does-not-check-gpg-signature
N:   debian-watch-may-check-gpg-signature
N:   This tag is experimental.
N:

E: Lintian run failed - policy violation (worst tag: error)
---
Best regards,
Simon Quigley
tsimonq2@debian.org

#1125688#39
Date:
2026-07-16 18:55:53 UTC
From:
To:
Hi, Simon.  Author/maintainer here.

Please note that my email address recently changed. The new one will be
reflected in my next package upload.

Simon Quigley wrote:
years ago) I was unsure of which section to use, too.

I considered utils, but since joystickwake is neither a command line
tool nor interactive, it didn't seem to fit with the packages that are
already in utils.

I considered x11, but since joystickwake doesn't depend on X11, that
seemed inaccurate. However, I see that some Wayland packages are now in
the x11 section, so maybe that would be an appropriate section for
joystickwake after all?

I chose games mainly for visibility: Joystickwake is specifically for
use with games, and would be pointless elsewhere, so having it listed in
the games section seemed like a decent way to help people who need it
discover it.

Sadly, I was unable to find any guidance in the Debian policy docs on
what qualifies a package for each archive section.

Would misc would be a better choice than games?

I would be happy to change it if I knew what section would be acceptable
to the Debian developers.

#1125688#44
Date:
2026-07-16 19:14:02 UTC
From:
To:
Hi Forest,

You can find a list of sections and their descriptions here: https://packages.debian.org/unstable/

To my understanding, the function of this package is to inhibit screen locking when using a joystick. While it's used for games, it isn't a game in and of itself, correct?

Utilities is described as:
 > Utilities for file/disk manipulation, backup and archive tools, system monitoring, input systems, etc.

To me, this seems like it would fit best.

To be clear, I'm not telling you that it must go in utils, but it doesn't fit in x11 or games, and utils seems like the next best fit.

I hope this helps.

Best regards,
Simon Quigley
tsimonq2@debian.org

#1125688#49
Date:
2026-07-16 20:16:06 UTC
From:
To:
Simon Quigley wrote:

Yes, now that I see that description of the utils section, I agree that
it's a better fit for joystickwake, which is not itself a game.
Thanks for the link.

My latest upload places joystickwake in the utils section.

It still needs a sponsor.

#1125688#54
Date:
2026-07-16 20:32:21 UTC
From:
To:

#1125688#61
Date:
2026-07-16 20:52:15 UTC
From:
To:
Hello,

Thanks for the latest revision.

$ dput ftp-master ../joystickwake_0.5.4-1_amd64.changes
Uploading joystickwake using ftp to ftp-master (host: ftp.upload.debian.org; directory: /pub/UploadQueue/)
running allowed-distribution: check whether a local profile permits uploads to the target distribution
running protected-distribution: warn before uploading to distributions where a special policy applies
running checksum: verify checksums before uploading
running suite-mismatch: check the target distribution for common errors
running gpg: check GnuPG signatures before the upload
Uploading joystickwake_0.5.4-1.dsc
Uploading joystickwake_0.5.4.orig.tar.gz
Uploading joystickwake_0.5.4-1.debian.tar.xz
Uploading joystickwake_0.5.4-1_all.deb
Uploading joystickwake_0.5.4-1_amd64.buildinfo
Uploading joystickwake_0.5.4-1_amd64.changes

It will now be in the Debian NEW queue, where it gets accepted or rejected. If it is rejected, please feel free to CC me on a followup and I can take another look if I'm available.

Best regards,
Simon Quigley
tsimonq2@debian.org

#1125688#68
Date:
2026-07-16 20:57:33 UTC
From:
To:
Actually mark as done :)
#1125688#73
Date:
2026-07-17 00:09:10 UTC
From:
To:
Thanks, Simon!