/ 
OrePAN2-0.54
⭐ Starred 22 / script/orepan2-merge-index

SYNOPSIS

% orepan2-merge-index -o merged.txt foo/02packages.details.txt bar/02packages.details.txt.gz

% orepan2-merge-index -o merged.txt \
    --orepan orepan/02packages.details.txt.gz \
    --cpan cpan/02packages.details.txt.gz \
    --protect-orepan-author DUMMY \
    --protect-orepan-author WATERKIP

DESCRIPTION

Combines 2 or more 02packages.details.txt.gz files.

DEVELOPMENT STATUS

Unstable

OPTIONS

o

% orepan2-merge-index -o merged.txt foo/02packages.details.txt bar/02packages.details.txt.gz

Name of output file

simple

Use a simple format for 02packages metadata. This helps avoid merge conflicts.

> orepan2-merge-index --simple -o merged.txt foo/02packages.details.txt bar/02packages.details.txt.gz

orepan / cpan

% orepan2-merge-index -o merged.txt --orepan orepan/02packages.details.txt.gz --cpan cpan/02packages.details.txt.gz

Merge a darkpan's own index (--orepan) with a CPAN mirror's index (--cpan). Without --protect-orepan-author, this behaves like the positional-file mode: the higher version of each package wins.

Only meaningful together; specifying one without the other is an error, as is passing any stray positional arguments alongside them.

protect-orepan-author

% orepan2-merge-index -o merged.txt --orepan o.txt --cpan c.txt \
    --protect-orepan-author DUMMY --protect-orepan-author WATERKIP

Repeatable. Any package whose --orepan index entry's path is authored by one of these PAUSE ids (i.e. the path looks like X/XX/AUTHORID/...) always keeps its --orepan entry, even if --cpan has a higher version for the same package. Matching is case-insensitive.

Only usable together with --orepan and --cpan; it's an error to pass it in positional-file mode, since protection isn't implemented there.

Protection is applied per package, not per distribution: if CPAN's copy of a protected author's distribution provides a package the --orepan copy doesn't, that package is still taken from CPAN.

A path not shaped like X/XX/AUTHORID/... (e.g. a flat filename) has no extractable author and so can never match, regardless of this option.