Incompatible CPAN modules

[miyagawa]

Here's a list of known modules that could cause problems in Carmel, with or without workarounds. If you want to report a module that's not in this list, please open a new issue.

Generated with .pm.PL

Some modules are generated by .pm.PL execution in configure, and META.json doesn't contain provides fields. This makes Menlo fail to record the correct version number from the generated .pm files. carmel install would fail when verifying the build artifacts to be valid, since there's no version information available.

• Proc::PID::File::Fcntl Issue with modules generated by .pm.PL file without META (e.g. Proc::PID::File::Fnctl) #71

There're some other modules that caused a similar issue in the past with Carton: perl-carton/carton#210 Most of them have been dealt with by fixing the metadata in the upstream.

Extra code triggered during make/Build

Some modules generate files during the make install execution, which Carmel doesn't run. carmel install succeeds, but you'll get a runtime error with carmel exec.

• XML::SAX XML::SAX installed with carmel doesn't find file #22

XS modules that are not relocatable

Some XS module with external C library dependencies record the installation path and does not work when relocated to a new directory. carmel install succeeds, but you'll get a loading error with carmel exec.

• Alien::TidyHTML5 "Build artifacts" may not work with modules depending on their initial installation paths #61

Invalid provides in install metadata

• Time::Piece::MySQL Can't find artifact for Time::Piece::MySQL only when Test::MockTime is also present #89

Invalid NAME in Makefile.PL and install metadata

Some modules have invalid NAME field in Makefile.PL and that causes invalid package recorded in install.json data generated by Menlo. Carmel would give you a warning when you run carmel update, when there's such a module in your dependencies. There's no actual harm with this issue other than a warning noise in the output.

• LWP (fixed in 6.65) fix NAME in Makefile.PL libwww-perl/libwww-perl#413
• Role::Identifiable (fixed in 0.008) NAME in Makefile.PL is invalid rjbs/Role-Identifiable#3