Basic checks over Debian packages
by (C) João Eriberto Mota Filho <eriberto (a) eriberto pro br>
Creation date: March 26, 2019.
Last update: see the footer.
Bit.ly: http://bit.ly/pkgcheck
Packaging status
- NEW:
- Verify using apt search.
- Verify using wnpp-check.
- Make an ITP.
- Is changelog closing the ITP?
- Is changelog set to experimental?
- Adoption:
- Verify if is really orphan.
- Make an ITA.
- Is changelog closing the ITA?
- NMU
- Is there a maintainer for the package?
- Only essential changes?
- Is changelog closing the bug?
- QA
- Is the package orphan?
- Is the "QA upload" set?
Initial check
- For *-1 revisions, diff between sources (package x upstream).
- NO-GIT: Run debdiff over the last and current .dsc file.
- GIT: git diff from last debian/<revision> tag.
- debian/changelog: were registered all changes shown by debdiff?
General checks
- There are previous works in a VCS?
- debian/copyright: all data were updated? (dates, maintainers, etc.). [1]
- debian/patches/: all headers are complete?
- Is possible to run debuild command twice?
- Is uscan working? (verify com uscan-check)
- Run spell command over debian/changelog and debian/control. [2]
- Verify the final structure using tree command. [3]
- If using Salsa, is the CI for Salsa enabled?
- Are all tests running? Use the autopkgtest. [4] (not needed if using Salsa)
- There are important files provided by upstream and useful for users not used? (README, TODO, etc.)
[1] The egrep command can be used to check (in upstream place):
$ egrep -sriA25 '(copyright|public dom)' > /tmp/copy $ egrep '(@|\[)' debian/changelog > /tmp/copy2
[2] The spell command will search for spelling errors. You can add new words to a personal dictionary at ~/.ispell_default
$ spell debian/changelog | sort -u
[3] You may use tree over generated structure:
$ tree debian/<package-name>
[4] To use autopkgtest (in upstream place):
$ autopkgtest . -- null
Checks in tracker
All checks here are related to https://tracker.debian.org. |
- Verify all itens in action needed.
- Verify the building in buildd. Click over log or exp (experimental).
- Verify all opened bugs (Debian and Ubuntu). Try to solve some bugs and close them in debian/changelog.
Final procedures
- Verify again all files inside debian/ directory.
- Run cowbuilder to test the building in a fresh jail. [5][6][7] (not needed if using Salsa)
- Run debidiff between .deb (old and current). (or use git diff)
- Install and test the final package.
- Update (push) the Git repository (if using Salsa).
- Verify the .changes content before upload to Debian.
[5] To create cowbuilder (outside the jail):
# cowbuilder create
[6] To update cowbuilder:
# cowbuilder update
[7] To use the cowbuilder:
# cowbuilder build /patch/name.dsc