Learn to build from source https://wiki.debian.org/BuildingTutorial
Understanding Breaking changes and Semantic Versioning https://semver.org
Update packages to new upstream versions https://wiki.debian.org/UpdatingaPackagetoNewUpstreamVersion
Webpack major changes from version 4 => 5 https://webpack.js.org/migrate/5/
For reporting bugs of failed packages https://www.debian.org/Bugs/Reporting
To search all bugs with webpack5 usertag https://udd.debian.org/cgi-bin/bts-usertags.cgi
Update the following packages (add your name next to the package before you start to avoid more than one person updating at same time)
node-isurl 4.0.1 to 4.0.2 (Caleb O.A.)
node-dompurify 2.3.0 to 2.3.3 (Caleb O.A.)
node-yargs 15.3.1 -> 17.2.1 (Ayoyimika)
node-jszip 3.5.0 to 3.7.1 (Ayoyimika)
node-lunr 2.3.8 to 2.3.9 (Caleb O.A.)
We need to test autopkgtest failure and rebuild failure for both nodejs and webpack.
autopkgtests are already known
For rebuilds, use Packaging/ruby-team-meta-build
- Find list of packages to fix
- See if new upstream versions are available
- See if new upstream version works
- Report bugs in debian
- Forward bugs upstream
- Fix packages and forward patches
Working with chroot
We basically have two separate chroots
The first one (debian-sid) is always for local development and is an unclean chroot having side-effects. The other one (unstable-amd64-sbuild) is for clean builds as it is a clean chroot.
If we manually installed anything in the clean chroot it becomes unclean also.
Building Webpack 5
There are two options to consider when building Webpack 5.
We either go through the manual work of modifying the debian/control file of individual reverse dependencies of Webpack 5 by adding webpack >= 5~ to make it test with Webpack 5 or,
- we make an exception by just building Webpack in an unclean chroot which would mean installing Webpack 5 in our clean chroot, thereby making it unclean. This will make Webpack 5 available to all reverse dependencies and will be used for their builds.
The first option involves a lot of manual work, modifying the debian/control file of all reverse dependencies. For example testing node-axios with Webpack 5 would mean adding webpack >= 5~ to its debian/control file. To make this easier we choose the second option, which is an exception that permits us to build in an unclean chroot just for Webpack 5. If chroot already has Webpack 5 then every package built using that chroot will use the chroot's installation of Webpack rather than installing Webpack 5 for each reverse dependencies, they all just use the global installation in the chroot.
Usually, sbuild will install only packages mentioned in build depends of debian/control file of each package in a clean chroot. But since we can't do the manual work of pointing the version of webpack in build depends of each package to 5. We install Webpack 5 in the chroot ourselves.
So we should discard this chroot and recreate a clean chroot after we test webpack 5.
Notes for webpack 5 porting
If a package wants to use webpack.config.babel.js, then it needs to add @babel/register in debian/nodejs/extlinks. TODO: patch webpack to look in /usr/share/nodejs for @babel/register.
[webpack-cli] Unable load '/home/ayoyimika/debian-js-packaging/mermaid/node-mermaid/.webpack/webpack.config.babel.js' [webpack-cli] Unable to use specified module loaders for ".babel.js". [webpack-cli] Cannot find module '@babel/register' from '/home/ayoyimika/debian-js-packaging/mermaid/node-mermaid/.webpack' [webpack-cli] Cannot find module 'babel-register' from '/home/ayoyimika/debian-js-packaging/mermaid/node-mermaid/.webpack' [webpack-cli] Cannot find module 'babel-core/register' from '/home/ayoyimika/debian-js-packaging/mermaid/node-mermaid/.webpack' [webpack-cli] Cannot find module 'babel/register' from '/home/ayoyimika/debian-js-packaging/mermaid/node-mermaid/.webpack' [webpack-cli] Please install one of them [webpack-cli] Error: Unable to use specified module loaders for ".babel.js".
Packages listed below are failing and seems harder to fix,
others - these could be removed if not fixed
rainloop 1001632 - patch available in salsa
pdf.js 1001631 - ready in salsa, need node-dommatrix to clear NEW
- ipywidgets - build failure seems unrelated to webpack 5
node-react-audio-player - this package can be removed from the archive
node-source-map 1004658 - salsa master branch has fix for webpack 5, but will need to update build to use packaged rust libraries instead of downloading from the internet.