Git::CPAN::Patch::Command::Import(3)

NAME
Git::CPAN::Patch::Command::Import - Import a module into a git repository

VERSION
version 2.5.0

SYNOPSIS
    # takes any string CPANPLUS handles:

    % git-cpan import Foo::Bar
    % git-cpan import A/AU/AUTHORID/Foo-Bar-0.03.tar.gz
    % git-cpan import http://backpan.cpan.org/authors/id/A/AU/AUTHORID/Foo-Bar-0.03.tar.gz

    # If the repository is already initialized, can be run with no arguments to
    # import the latest version
    git-cpan import

DESCRIPTION
This command is used internally by "git-cpan-init", "git-cpan-update" and "git-backpan-init".

This command takes a tarball, extracts it, and imports it into the repository.

It is only possible to update to a newer version of a module.

The module history is tracked in "refs/remotes/cpan/master".

Tags are created for each version of the module.

This command does not touch the working directory, and is safe to run even if you have pending work.

OPTIONS

--check, --nocheck
    Explicitly enables/disables version checking. If version checking is enabled, which is the default, git-cpan-import will refuse to import a version of the package that has a smaller version number than the HEAD of the branch cpan/master.

--parent
    Allows adding extra parents when importing, so that when a patch has been incorporated into an upstream version the generated commit is like a merge commit, incorporating both the CPAN history and the user's local history.

    For example, this will set the current HEAD of the master branch as a parent of the imported CPAN package:

        $ git checkout master
        $ git-cpan import --parent HEAD My-Module

    More than one '--parent' can be specified.

--author_name
    Forces the author name to the given value, instead of trying to resolve it from the release metadata.

--author_email
    Forces the author email to the given value, instead of trying to resolve it from the release metadata.

AUTHORS
Yuval Kogman "<nothingmuch@woobling.org>"

Yanick Champoux "<yanick@cpan.org>"

SEE ALSO
Git::CPAN::Patch

AUTHOR
Yanick Champoux <yanick@cpan.org>

COPYRIGHT AND LICENSE
This software is copyright (c) 2022, 2021, 2018, 2017, 2016, 2015, 2014, 2013, 2012, 2011, 2010, 2009 by Yanick Champoux.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.