Latest revision as of 07:35, 6 July 2018

Perl Move to MetaCPAN

Summary

search.cpan.org web frontend for CPAN is being replaced by metacpan.org. Many Perl RPM packages refer to search.cpan.org. This Fedora change aims to mass-update URL and Source RPM tags in affected Perl packages.

Owner

Name: Petr Písař
Email: <ppisar@redhat.com>
Release notes owner:

Current status

Targeted release: Fedora 29
Last updated: 2018-07-06
Tracker bug: #1585624
Release Notes tracking: #176

Completed items

Update packaging guidelines
Develop regular expressions for address rewrite
- URL: s{\Ahttp://(?:(?i)search\.cpan\.org)/(?:dist|~[^/]+)/([^/]+)/?\s*\z}{https://metacpan.org/release/$1}
- Source: s{\Ahttps?://(?:(?:(?i)www\.cpan\.org)(?:/CPAN)?|(?:(?i)search\.cpan\.org)/CPAN)/+(authors/id/|modules/by-module/|modules/by-authors/id/)}{https://cpan.metacpan.org/$1}
Gather list of Perl packages
- Packages containing old strings: 2852
Dry-run mass-update script to validate output and identify issues
Update affected specification files
Manually update (invalid or not automatically rewritable or special):
- perl
- perl-Crypt-Blowfish_PP
- perl-Data-AMF
- perl-Text-Kakasi

Items in progress

Items to be done

Detailed Description

Fedora packages store URL to the upstream web page and URL to the source archive location in their metadata. Most of the Perl packages uses search.cpan.org for this purpose. However, search.cpan.org won't be the canonical source anymore. We should update the metadata to point to the new location.

Specification for all Perl packages will be updated like this:

-URL:            http://search.cpan.org/dist/CPANPLUS/
+URL:            https://metacpan.org/release/CPANPLUS
-Source0:        http://www.cpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz
-Source0:        http://search.cpan.org/CPAN/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz
+Source0:        https://cpan.metacpan.org/authors/id/B/BI/BINGOS/CPANPLUS-%{cpan_version}.tar.gz

This change will be pushed as one commit into each affected Perl package without increasing its release number. We will try to do this change before Perl 5.28 mass rebuild in order to have it visible in Fedora 29 binary repositories.

Benefit to Fedora

Provide up-to-date home page in package descriptions to Fedora users. Fetch sources into Fedora infrastructure directly from upstream location.

Scope

Proposal owners: Rewrite URL and Source addresses in Perl package specification files.

Other developers: Make sure the new addresses are correct.

Release engineering: Review ticket
- List of deliverables: Does not block any deliverables.

Policies and guidelines: Perl packaging guidelines will be updated.

Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

This change has no impact on run-time.

How To Test

Package rebuilt after this change won't display search.cpan.org in rpm -qi output.

User Experience

URL in in RPM packages uses metacpan.org instead of search.cpan.org.

Dependencies

There are no dependencies.

Contingency Plan

In case the new addresses won't work, we will revert them in the specification files and in the Perl packaging guidelines.

Documentation

search.cpan.org – the old web interface
metacpan.org – the new web interface
Perl NOC announcement
Perl packaging guidelines
Discussion on perl-devel Fedora mailing list
Announcement on devel Fedora mailing list
Anitya CPAN backend update request
Perl packaging guidelines update request
Releng review request
cpanspec tool update request

Release Notes

This change does not need to be highlighted in the release notes.

@@ Line 27: / Line 27: @@
 CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development
 -->
-* Tracker bug: <will be assigned by the Wrangler>
+* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1585624 #1585624]
+* Release Notes tracking: [https://pagure.io/fedora-docs/release-notes/issue/176 #176]
 === Completed items ===
@@ Line 34: / Line 35: @@
 ** URL: <code><nowiki>s{\Ahttp://(?:(?i)search\.cpan\.org)/(?:dist|~[^/]+)/([^/]+)/?\s*\z}{https://metacpan.org/release/$1}</nowiki></code>
 ** Source: <code><nowiki>s{\Ahttps?://(?:(?:(?i)www\.cpan\.org)(?:/CPAN)?|(?:(?i)search\.cpan\.org)/CPAN)/+(authors/id/|modules/by-module/|modules/by-authors/id/)}{https://cpan.metacpan.org/$1}</nowiki></code>
-* Dry-run mass-update script to validate output and identify issues
-=== Items in progress ===
 * Gather list of Perl packages
 ** Packages containing old strings: 2852
+* Dry-run mass-update script to validate output and identify issues
-=== Items to be done ===
 * Update affected specification files
 * Manually update (invalid or not automatically rewritable or special):
@@ Line 47: / Line 44: @@
 ** perl-Data-AMF
 ** perl-Text-Kakasi
+=== Items in progress ===
+=== Items to be done ===
 == Detailed Description ==
@@ Line 99: / Line 100: @@
 * [https://fedoraproject.org/wiki/Packaging:Perl Perl packaging guidelines]
 * [https://lists.fedoraproject.org/archives/list/perl-devel@lists.fedoraproject.org/thread/4AMIYRZBZDW2H5274FXIRGNJLCWHQK7Q/#4AMIYRZBZDW2H5274FXIRGNJLCWHQK7Q Discussion on perl-devel Fedora mailing list]
+* [https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/353QSBFTO4ZX7CMGPWWNGUZXZ342TRND/ Announcement on devel Fedora mailing list]
 * [https://github.com/release-monitoring/anitya/issues/558 Anitya CPAN backend update request]
 * [https://pagure.io/packaging-committee/issue/770 Perl packaging guidelines update request]
@@ Line 107: / Line 109: @@
 This change does not need to be highlighted in the release notes.
-[[Category:ChangeReadyForFesco]]
+[[Category:ChangeAcceptedF29]]
 <!-- When your change proposal page is completed and ready for review and announcement -->
 <!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->

Search

Changes/Perl Move to MetaCPAN: Difference between revisions