NAME¶

Dist::Zilla::Plugin::Git::Init - initialize git repository on dzil new

VERSION¶

version 2.025

SYNOPSIS¶

In your profile.ini:

    [Git::Init]
    commit_message = initial commit  ; this is the default
    commit = 1                       ; this is the default
    branch =                         ; this is the default (means master)
    remote = origin git@github.com:USERNAME/%{lc}N.git ; no default
    config = user.email USERID@cpan.org  ; there is no default

DESCRIPTION¶

This plugin initializes a git repository when a new distribution is created with "dzil new".

Plugin options¶

The plugin accepts the following options:

•

commit_message - the commit message to use when checking in the newly-minted dist. Defaults to "initial commit".

•

commit - if true (the default), commit the newly-minted dist. If set to a false value, add the files to the Git index but don't actually make a commit.

•

branch - the branch name under which the newly-minted dist is checked in (if "commit" is true). Defaults to an empty string, which means that the Git default branch is used (master).

•

config - a config setting to make in the repository. No config entries are made by default. A setting is specified as "OPTION VALUE". This may be specified multiple times to add multiple entries.

•

remote - a remote to add to the repository. No remotes are added by default. A remote is specified as "NAME URL". This may be specified multiple times to add multiple remotes.

Formatting options¶

You can use the following codes in "commit_message", "config", or "remote":

%n

A newline.

%N

The distribution name. You can also use "%{lc}N" or "%{uc}N" to get the name in lower case or upper case, respectively.

AUTHOR¶

Jerome Quelin

COPYRIGHT AND LICENSE¶

This software is copyright (c) 2009 by Jerome Quelin. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.