Update projects¶

dfetch update fetches every dependency listed in dfetch.yaml and places the requested version in its destination folder. VCS type (Git, SVN, or plain archive) is detected automatically.

Fetching all projects — fetch all projects at once
Updating a single project — update a single project
Overwriting local changes — overwrite local changes
Sub-manifests — nested manifests in dependencies
Git submodules — Git submodules inside dependencies

Fetching all projects¶

Run without arguments to fetch every project in the manifest:

$ dfetch update

Dfetch reads dfetch.yaml, resolves each project’s VCS type, and writes the requested revision into the destination folder. A .dfetch_data.yaml metadata file is created inside each destination so Dfetch can track what version is present.

Example: Git projects are specified in the manifest

../features/fetch-git-repo.feature¶

Given the manifest 'dfetch.yaml'
    """
    manifest:
      version: '0.0'

      remotes:
        - name: github-com-dfetch-org
          url-base: https://github.com/dfetch-org/test-repo

      projects:
        - name: ext/test-repo-rev-only
          revision: e1fda19a57b873eb8e6ae37780594cbb77b70f1a
          dst: ext/test-repo-rev-only

        - name: ext/test-rev-and-branch
          revision: 8df389d0524863b85f484f15a91c5f2c40aefda1
          branch: main
          dst: ext/test-rev-and-branch

        - name: ext/test-repo-tag-v1
          tag: v1
          dst: ext/test-repo-tag-v1

    """
When I run "dfetch update"
Then the following projects are fetched
    | path                       |
    | ext/test-repo-rev-only     |
    | ext/test-rev-and-branch    |
    | ext/test-repo-tag-v1       |

Example: Tag is updated in manifest

../features/fetch-git-repo.feature¶

Given the manifest 'dfetch.yaml'
    """
    manifest:
      version: '0.0'

      projects:
        - name: ext/test-repo-tag
          url: https://github.com/dfetch-org/test-repo
          tag: v1

    """
And all projects are updated
When the manifest 'dfetch.yaml' is changed to
    """
    manifest:
      version: '0.0'

      projects:
        - name: ext/test-repo-tag
          url: https://github.com/dfetch-org/test-repo
          tag: v2.0

    """
And I run "dfetch update"
Then the output shows
    """
    Dfetch (0.13.0)
      ext/test-repo-tag:
      > Fetched v2.0
    """

Example: Version check ignored when force flag is given

../features/fetch-git-repo.feature¶

Given the manifest 'dfetch.yaml'
    """
    manifest:
      version: '0.0'

      projects:
        - name: ext/test-repo-tag
          url: https://github.com/dfetch-org/test-repo
          tag: v1

    """
And all projects are updated
When I run "dfetch update --force"
Then the output shows
    """
    Dfetch (0.13.0)
      ext/test-repo-tag:
      > Fetched v1
    """

Example: SVN projects are specified in the manifest

../features/fetch-svn-repo.feature¶

Given the manifest 'dfetch.yaml'
    """
    manifest:
      version: '0.0'

      remotes:
        - name: cunit
          url-base: svn://svn.code.sf.net/p/cunit/code
          default: true

        - name: cutter
          url-base: svn://svn.code.sf.net/p/cutter/svn/cutter

      projects:
        - name: cunit-svn-rev-only
          revision: '176'
          vcs: svn
          dst: ext/cunit-svn-rev-only

        - name: cunit-svn-rev-and-branch
          revision: '156'
          vcs: svn
          branch: mingw64
          dst: ext/cunit-svn-rev-and-branch

        - name: cutter-svn-tag
          vcs: svn
          tag: 1.1.7
          src: acmacros
          dst: ext/cutter-svn-tag
          remote: cutter

    """
When I run "dfetch update"
Then the following projects are fetched
    | path                         |
    | ext/cunit-svn-rev-only       |
    | ext/cunit-svn-rev-and-branch |
    | ext/cutter-svn-tag           |

Example: Directory in a non-standard SVN repository can be fetched

../features/fetch-svn-repo.feature¶

Given the manifest 'dfetch.yaml' in MyProject
    """
    manifest:
        version: 0.0
        projects:
            - name: SomeProject
              url: some-remote-server/SomeProject
              src: SomeFolder/
              branch: ' '
    """
And a non-standard svn-server "SomeProject" with the files
    | path                                  |
    | SomeFolder/SomeFile.txt               |
    | SomeOtherFolder/SomeOtherFile.txt     |
When I run "dfetch update"
Then 'MyProject' looks like:
    """
    MyProject/
        SomeProject/
            .dfetch_data.yaml
            SomeFile.txt
        dfetch.yaml
    """

Example: SVN repository with a tags can be fetched

../features/fetch-svn-repo.feature¶

Given the manifest 'dfetch.yaml' in MyProject
    """
    manifest:
        version: 0.0
        projects:
            - name: SomeProject
              url: some-remote-server/SomeProject
              tag: 'v1.2.3'

            - name: SomeOtherProject
              url: some-remote-server/SomeOtherProject
              tag: 'v 1&;{6}'
    """
And a svn-server "SomeProject" with the tag "v1.2.3"
And a svn-server "SomeOtherProject" with the tag "v 1&;{6}"
When I run "dfetch update"
Then 'MyProject' looks like:
    """
    MyProject/
        SomeOtherProject/
            .dfetch_data.yaml
            README.md
        SomeProject/
            .dfetch_data.yaml
            README.md
        dfetch.yaml
    """

Example: Tar.gz archive project is fetched