NAME
Dist::Zilla::Plugin::Git::Checkout - clone and checkout a Git repository
VERSION
Version 0.004
SYNOPSIS
# in dist.ini:
[Git::Checkout]
:version = 0.004
repo = https://github.com/skirmess/dzil-inc.gitDESCRIPTION
This plugin clones, or if it is already cloned, fetches and updates a Git repository.
The plugin runs during the initialization phase, which is the same for bundles and plugins. You can check out a Git repository and load bundles or plugins from this repository.
# in dist.ini
[Git::Checkout]
:version = 0.004
repo = https://github.com/skirmess/dzil-inc.git
; add the lib directory inside the checked out Git repository to @INC
[lib]
lib = dzil-inc/lib
; this bundle is run from inside the checked out Git repositories lib
; directory
[@BundleFromRepository]Git version 1.7.10 or later is required.
USAGE
branch / revision / tag
Available since version 0.004.
Specifies what to check out. This can be a branch, a tag or a revision. Only one of these three options can be used.
If none is specified it defaults to the branch returned by
git symbolic-ref -q --short refs/remotes/origin/HEADand if that doesn't exist to the branch master.
dir
The repositories workspace is checked out into this directory. This defaults to the basename of the repo without the .git suffix.
push_url
Allows you to specify a different push url for the repositories origin. One possible scenario would be if you would like to clone via https but push via ssh. This is optional.
repo
Specifies the address of the repository to clone. This is required.
SUPPORT
Bugs / Feature Requests
Please report any bugs or feature requests through the issue tracker at https://github.com/skirmess/Dist-Zilla-Plugin-Git-Checkout/issues. You will be notified automatically of any progress on your issue.
Source Code
This is open source software. The code repository is available for public review and contribution under the terms of the license.
https://github.com/skirmess/Dist-Zilla-Plugin-Git-Checkout
git clone https://github.com/skirmess/Dist-Zilla-Plugin-Git-Checkout.gitAUTHOR
Sven Kirmess <sven.kirmess@kzone.ch>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2020-2022 by Sven Kirmess.
This is free software, licensed under:
The (two-clause) FreeBSD License