repository·devel·Indexed 21 days ago
https://github.com/miyagawa/cpanminusA tool for getting, unpacking, building, and installing Perl modules from CPAN. The project consists of the App-cpanminus frontend and the Menlo backend, which provides a scriptable API and modular interface for cpanm 2.0. It supports installation to system Perl, local Perl (via perlbrew or plenv), and local::lib.
The miyagawa/cpanminus repository is a monorepo containing two distinct distributions:
cpanm frontend used for interacting with CPAN.Developers can use this repository to access both the frontend tool and the underlying logic used to get, unpack, build, and install modules from CPAN.
cpanm 2.0 designed to be a more flexible, extensible, and easier-to-use replacement for the internals of the original cpanm. Unlike the original cpanm, which is implemented as a single script with a 'God class' and packaged via fatpacker, Menlo is implemented as a standard set of Perl modules. This allows developers to extend its behavior through modular interfaces or by writing plugins, rather than relying on shell wrappers or parsing stdout/logs.Modules are installed based on the configuration of ExtUtils::MakeMaker and Module::Build (via PERL_MM_OPT and PERL_MB_OPT).
site_perl directory (e.g., /opt/local/perl/...). Requires root or --sudo.local::lib is configured in your shell, cpanm respects those settings and installs to your local perl5 directory.local::lib configured, cpanm will automatically set up a local::lib compatible installation path in a perl5 directory under your home directory.While cpanm is a lightweight, dependency-free, and configuration-free tool, its monolithic implementation makes it difficult to modify at runtime without forking or monkeypatching.
Menlo maintains the core benefits of cpanm (lightweight, fast, dependency-free installation) but provides a scriptable API and hook points. It is available as a standard Perl module on CPAN, enabling programmatic integration and extensibility that the original cpanm lacks.
You can download the standalone cpanm executable directly to a specific location. Note that if you use this method, the --self-upgrade command might not work, so you will need to manually download a new version when upgrading.
cd ~/bin
curl -L https://cpanmin.us/ -o cpanm
chmod +x cpanmIf you are using a Perl installation located in your home directory (such as those managed by perlbrew or plenv), you can install cpanm without sudo because you have write permissions to the library path. This will install the executable to your Perl's bin path.
curl -L https://cpanmin.us | perl - App::cpanminusInstall Menlo::Legacy to provide the Menlo::CLI::Compat library. This library implements the classic version of cpanm internals and behaviors, ensuring stability for downstream clients that rely on specific cpanm logic.
Use Menlo::Legacy if you are using API clients such as:
CartonCarmelApp::cpmBy using this compatibility layer, these tools can continue to rely on stable cpanm features even as the underlying Menlo platform evolves or undergoes refactoring.
To install the latest version of cpanm directly into your system's Perl installation (e.g., /usr/local/bin), use the following command. Note that you will likely need --sudo to write to system directories unless you have configured local::lib via INSTALL_BASE.
curl -L https://cpanmin.us | perl - --sudo App::cpanminusHash::MultiValue is an object (and a blessed hash reference) designed to handle cases where a single key may have multiple associated values, such as web request parameters. It allows you to treat the object like a standard hash for single-value access while providing an explicit API to retrieve all values for a key.
$hash->{key} or $hash->get($key), the last value entered for that key is returned. This mimics standard Perl behavior (e.g., merging hashes or taking a scalar from a list).$hash->get_all($key) to retrieve all values associated with a key as a list.keys %$hash returns only unique keys (standard hash behavior).$hash->keys returns all keys, including duplicates, in the order they were added.use Hash::MultiValue;
my $hash = Hash::MultiValue->new(
foo => 'a',
foo => 'b',
bar => 'baz',
);
my $foo = $hash->{foo}; # 'b' (the last entry)
my $foo = $hash->get('foo'); # 'b'
my @foo = $hash->get_all('foo'); # ('a', 'b')
keys %$hash; # ('foo', 'bar')
$hash->keys; # ('foo', 'foo', 'bar')cpanm unpacks fetched files in ~/.cpanm and cleans them up periodically. You can change this location by setting the PERL_CPANM_HOME environment variable.When modifying a Hash::MultiValue object, do not use the standard hash reference interface (e.g., $hash->{key} = $val or delete $hash->{key}). Doing so will update the underlying hash but will not update the internal tracking object used to manage multiple values.
Instead, use the provided mutation methods:
add($key, $value, ...): Appends new values to a key.set($key, $value, ...): Replaces existing values for a key with the new set.remove($key): Removes the key and all its associated values.clear: Empties the hash.my $hash = Hash::MultiValue->new();
# WRONG: This bypasses the multi-value tracker
$hash->{foo} = 'bar';
delete $hash->{foo};
# Correct: This updates the tracker correctly
$hash->add(foo => 'bar');
$hash->remove('foo');# WRONG
$hash->{foo} = 'bar';
delete $hash->{foo};
# Correct
$hash->add(foo => 'bar');
$hash->remove('foo');You can clone the source code directly from the public Git repository to your local machine.
git clone http://repo.or.cz/r/Spreadsheet-Read.git Spreadsheet-Read