++ed by:

26 PAUSE user(s)
5 non-PAUSE user(s).

Christopher J. Madsen


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


version 2.023


In your profile.ini:

    commit_message = initial commit  ; this is the default
    commit = 1                       ; this is the default
    remote = origin git@github.com:USERNAME/%{lc}N.git ; no default
    config = user.email USERID@cpan.org  ; there is no default


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.

  • 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:


A newline.


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


Jerome Quelin


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.

Hosting generously
sponsored by Bytemark