C.18 GitFetchTask
Prev | Appendix C. Optional tasks | Next

## C.18 GitFetchTask

Download objects and refs from another repository. See official documentation.

Table C.19: Attributes

Name | Type | Description | Default | Required
--- | --- | --- | --- | ---
`gitPath` | `String` | Path to Git binary | /usr/bin/git | No
`repository` | `String` | Path to Git repository | n/a | Yes
`source` | `String` | The "remote" repository that is the source of a fetch or pull operation. See <repository> in git-fetch. | origin | No
`refspec` | `String` | See <refspec> in git-fetch. |  | No
`group` | `String` | A name referring to a list of repositories as the value of remotes.<group> in the configuration file. See <group> in git-fetch. |  | No
`quiet` | `Boolean` | Silence any internally used git commands. Progress is not reported to the standard error stream. See --quiet in git-fetch. | `false` | No
`all` | `Boolean` | Fetch all remotes. See --all in git-fetch. | `false` | No
`keep` | `Boolean` | Keep downloaded pack. See --keep in git-fetch. | `false` | No
`prune` | `Boolean` | After fetching, remove any remote tracking branches which no longer exist on the remote. See --prune in git-fetch. | `false` | No
`tags` | `Boolean` | See --tags in git-fetch. | `false` | No
`notags` | `Boolean` | See --no-tags in git-fetch. | `false` | No
`force` | `Boolean` | When git fetch is used with <rbranch>:<lbranch> refspec, it refuses to update the local branch <lbranch> unless the remote branch <rbranch> it fetches is a descendant of <lbranch>. This option overrides that check. See --force in git-fetch. | `false` | No

### C.18.1 Example

    <property name="repo.dir" value="./relative/path/to/repo" />
    <resolvepath propertyName="repo.dir.resolved" file="${repo.dir}" />

    <!-- Initialize normal repository -->
    <gitinit repository="${repo.dir.resolved}" />

    <!-- Fetch objects from all remotes -->
    <gitfetch
        repository="${repo.dir.resolved}" all="true" />

    <!-- Fetch from origin/master to "refspec-branch" local branch -->
    <gitfetch
        repository="${repo.dir.resolved}"
        source="origin"
        refspec="master:refspec-branch"
        quiet="true" />

Prev | Up | Next
C.17 GitBranchTask | Home | C.19 GitCheckoutTask