Skip to content

Commit cca714b

Browse files
committed
Add archive method to readme & landing page
1 parent 8fa0797 commit cca714b

2 files changed

Lines changed: 19 additions & 9 deletions

File tree

README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,8 @@ Dfetch must promote upstreaming changes, but allow for local customizations.
2929
The problem is described thoroughly in [managing external dependencies](https://embeddedartistry.com/blog/2020/06/22/qa-on-managing-external-dependencies/) and sometimes
3030
is also known as [*vendoring*](https://dfetch.readthedocs.io/en/latest/vendoring.html).
3131

32+
Dfetch supports three source types: **Git**, **SVN**, and **archive files** (`.tar.gz`, `.tgz`, `.tar.bz2`, `.tar.xz`, `.zip`). Archives can be verified with a cryptographic hash (`sha256`, `sha384`, or `sha512`) to guarantee integrity on every fetch.
33+
3234
Other tools that do similar things are ``Zephyr's West``, ``CMake ExternalProject`` and other meta tools.
3335
See [alternatives](https://dfetch.readthedocs.io/en/latest/alternatives.html) for a complete list.
3436

@@ -43,7 +45,8 @@ See [alternatives](https://dfetch.readthedocs.io/en/latest/alternatives.html) fo
4345
* Compose multi-repo code bases into a single working tree
4446
* Vendoring dependencies for reproducible builds
4547
* Apply local patches while keeping upstream syncable
46-
* VCS-agnostic dependency management
48+
* VCS-agnostic dependency management (Git, SVN, and plain archives)
49+
* Fetch and verify archives with cryptographic integrity checks
4750
* Self-contained exports for releases or audits
4851

4952
## Install
@@ -110,6 +113,13 @@ manifest:
110113
dst: Tests/cpputest-git-src
111114
repo-path: cpputest/cpputest.git
112115
src: src
116+
117+
- name: my-library
118+
dst: ext/my-library
119+
url: https://example.com/releases/my-library-1.0.tar.gz
120+
vcs: archive
121+
integrity:
122+
hash: sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
113123
```
114124
115125
## Github Action

doc/landing-page/index.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
:sd_hide_title:
44

55
.. meta::
6-
:description: Dfetch vendors source code from Git and SVN repositories directly into your project. No submodules, no lock-in, fully self-contained.
7-
:keywords: dfetch, dependency management, vendoring, git, svn, embedded development, source-only dependencies, multi-repo, supply chain, sbom, license compliance
6+
:description: Dfetch vendors source code from Git or SVN repositories or plain archives directly into your project. No submodules, no lock-in, fully self-contained.
7+
:keywords: dfetch, dependency management, vendoring, git, svn, archive, embedded development, source-only dependencies, multi-repo, supply chain, sbom, license compliance
88
:author: Dfetch Contributors
99
:google-site-verification: rXUIdonVCg6XtZUDdOd7fJdSNj3bOoJJRqCFn3OVb04
1010

@@ -31,8 +31,8 @@ Dfetch
3131
**Vendor dependencies without the pain.**
3232

3333
**Dfetch** copies source code directly into your project — no Git submodules, no SVN externals,
34-
no hidden external links. Dependencies live as plain, readable files inside your own repository.
35-
You stay in full control of every line.
34+
no hidden external links. Fetch from Git, SVN, or plain archive URLs. Dependencies live as plain,
35+
readable files inside your own repository. You stay in full control of every line.
3636

3737
.. grid:: 1 3 3 3
3838
:gutter: 3
@@ -180,8 +180,8 @@ You stay in full control of every line.
180180
:text-align: center
181181
:class-card: stat-card
182182

183-
Works with **Git and SVN** — even mixed in the same project.
184-
The only dependency manager that bridges both without compromise.
183+
Works with **Git, SVN, and archive URLs** — even mixed in the same project.
184+
The only dependency manager that bridges these without compromise.
185185

186186
.. grid-item-card:: :material-regular:`code;2em` Any language, any build system
187187
:text-align: center
@@ -296,8 +296,8 @@ You stay in full control of every line.
296296

297297
:material-regular:`shuffle;1.5em;sd-text-primary` **VCS-agnostic**
298298

299-
Works seamlessly with **Git and SVN** — even mixed within the same project.
300-
Pin by tag, branch, revision, or exact commit hash. Adapt to your team's workflow, not the other way around.
299+
Works seamlessly with **Git, SVN, and archive URLs** — even mixed within the same project.
300+
Pin by tag, branch, revision, commit hash, or cryptographic hash. Adapt to your team's workflow, not the other way around.
301301

302302
.. grid-item::
303303

0 commit comments

Comments
 (0)