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.