libgit2 · malcolmwood76 · Jun 19, 2025 · Jun 19, 2025 · Jun 19, 2025 · Jun 20, 2025
diff --git a/include/git2/remote.h b/include/git2/remote.h
@@ -762,9 +762,15 @@ typedef enum {
 	GIT_FETCH_DEPTH_FULL = 0,
 
 	/** The fetch should "unshallow" and fetch missing data. */
-	GIT_FETCH_DEPTH_UNSHALLOW = 2147483647
+	GIT_FETCH_DEPTH_UNSHALLOW = 2147483647,
 } git_fetch_depth_t;
 
+typedef enum {
+	/** The fetch is "full" (not shallow). This is the default. */
+	GIT_FETCH_SINCE_FULL = 0
+} git_fetch_since_t;
+
+
 /**
  * Fetch options structure.
  *
@@ -808,12 +814,22 @@ typedef struct {
 	/**
 	 * Depth of the fetch to perform, or `GIT_FETCH_DEPTH_FULL`
 	 * (or `0`) for full history, or `GIT_FETCH_DEPTH_UNSHALLOW`
-	 * to "unshallow" a shallow repository.
+	 * to "unshallow" a shallow repository. Cannot be used in
+	 * conjunction with a specific shallow_since date.
 	 *
 	 * The default is full (`GIT_FETCH_DEPTH_FULL` or `0`).
 	 */
 	int depth;
 
+	/**
+	 * Date from which to fetch history, or 'GIT_FETCH_SINCE_FULL'
+	 * to fetch all history.
+	 * Cannot be used in conjuction with a specific depth.
+	 *
+	 * The default is to fetch all history (`GIT_FETCH_SINCE_FULL` or `-1`).
+	 */
+	git_time_t shallow_since;
+
 	/**
 	 * Whether to allow off-site redirects.  If this is not
 	 * specified, the `http.followRedirects` configuration setting
@@ -837,7 +853,11 @@ typedef struct {
 	GIT_FETCH_PRUNE_UNSPECIFIED, \
 	GIT_REMOTE_UPDATE_FETCHHEAD, \
 	GIT_REMOTE_DOWNLOAD_TAGS_UNSPECIFIED, \
-	GIT_PROXY_OPTIONS_INIT }
+	GIT_PROXY_OPTIONS_INIT, \
+	GIT_FETCH_DEPTH_FULL, \
+	GIT_FETCH_SINCE_FULL, \
+	GIT_REMOTE_REDIRECT_NONE \
+}
 
 /**
  * Initialize git_fetch_options structure

diff --git a/include/git2/sys/transport.h b/include/git2/sys/transport.h
@@ -38,6 +38,7 @@ typedef struct {
 	git_oid *shallow_roots;
 	size_t shallow_roots_len;
 	int depth;
+	git_time_t shallow_since;
 } git_fetch_negotiation;
 
 struct git_transport {

diff --git a/src/libgit2/clone.c b/src/libgit2/clone.c
@@ -619,7 +619,7 @@ static int clone_repo(
 	/* enforce some behavior on fetch */
 	options.fetch_opts.update_fetchhead = 0;
 
-	if (!options.fetch_opts.depth)
+	if (!options.fetch_opts.depth && !options.fetch_opts.shallow_since)
 		options.fetch_opts.download_tags = GIT_REMOTE_DOWNLOAD_TAGS_ALL;
 
 	/* Only clone to a new directory or an empty directory */

diff --git a/src/libgit2/fetch.c b/src/libgit2/fetch.c
@@ -64,6 +64,7 @@ static int mark_local(git_remote *remote)
 		   depth, we need to ask for it even though the head
 		   exists locally. */
 		if (remote->nego.depth == GIT_FETCH_DEPTH_FULL &&
+		    remote->nego.shallow_since == GIT_FETCH_SINCE_FULL &&
 		    git_odb_exists(odb, &head->oid))
 			head->local = 1;
 		else
@@ -177,6 +178,7 @@ int git_fetch_negotiate(git_remote *remote, const git_fetch_options *opts)
 	if (opts) {
 		GIT_ASSERT_ARG(opts->depth >= 0);
 		remote->nego.depth = opts->depth;
+		remote->nego.shallow_since = opts->shallow_since;
 	}
 
 	if (filter_wants(remote, opts) < 0)

diff --git a/src/libgit2/transports/local.c b/src/libgit2/transports/local.c
@@ -299,7 +299,7 @@ static int local_negotiate_fetch(
 
 	GIT_UNUSED(wants);
 
-	if (wants->depth) {
+	if (wants->depth || wants->shallow_since) {
 		git_error_set(GIT_ERROR_NET, "shallow fetch is not supported by the local transport");
 		return GIT_ENOTSUPPORTED;
 	}

diff --git a/src/libgit2/transports/smart_pkt.c b/src/libgit2/transports/smart_pkt.c
@@ -828,13 +828,40 @@ int git_pkt_buffer_wants(
 	}
 
 	if (wants->depth > 0) {
+
+		if (wants->shallow_since > 0) {
+			git_error_set(
+			        GIT_ERROR_NET,
+			        "depth and shallow-since must not be used together");
+			return GIT_EINVALID;
+		}
+
 		git_str deepen_buf = GIT_STR_INIT;
 
 		git_str_printf(&deepen_buf, "deepen %d\n", wants->depth);
 		git_str_printf(buf,"%04x%s", (unsigned int)git_str_len(&deepen_buf) + 4, git_str_cstr(&deepen_buf));
 
 		git_str_dispose(&deepen_buf);
 
+		if (git_str_oom(buf))
+			return -1;
+
+	} else if (wants->shallow_since > 0) {
+
+		git_str shallow_since_buf = GIT_STR_INIT;
+
+		/* The git command-line option is "shallow-since", but the protocol uses "deepen-since" */
+		git_str_printf(
+		        &shallow_since_buf, "deepen-since %d\n",
+		        wants->shallow_since);
+
+		git_str_printf(
+		        buf, "%04x%s",
+		        (unsigned int)git_str_len(&shallow_since_buf) + 4,
+		        git_str_cstr(&shallow_since_buf));
+
+		git_str_dispose(&shallow_since_buf);
+
 		if (git_str_oom(buf))
 			return -1;
 	}

diff --git a/src/libgit2/transports/smart_protocol.c b/src/libgit2/transports/smart_protocol.c
@@ -435,7 +435,7 @@ int git_smart__negotiate_fetch(
 	if ((error = git_revwalk__push_glob(walk, "refs/*", &opts)) < 0)
 		goto on_error;
 
-	if (wants->depth > 0) {
+	if (wants->depth > 0 || wants->shallow_since > 0) {
 		git_pkt_shallow *pkt;
 
 		if ((error = git_smart__negotiation_step(&t->parent, data.ptr, data.size)) < 0)

diff --git a/tests/libgit2/online/shallow.c b/tests/libgit2/online/shallow.c
@@ -1,6 +1,7 @@
 #include "clar_libgit2.h"
 #include "futils.h"
 #include "repository.h"
+#include "date.h"
 
 static int remote_single_branch(git_remote **out, git_repository *repo, const char *name, const char *url, void *payload)
 {
@@ -124,6 +125,135 @@ void test_online_shallow__clone_depth_five(void)
 	git_repository_free(repo);
 }
 
+void test_online_shallow__clone_since_oldest(void)
+{
+	git_str path = GIT_STR_INIT;
+	git_repository *repo;
+	git_revwalk *walk;
+	git_clone_options clone_opts = GIT_CLONE_OPTIONS_INIT;
+	git_oid oid;
+	git_oid *roots;
+	size_t roots_len;
+	size_t num_commits = 0;
+	int error = 0;
+
+	/* Specify a date before the oldest commit. */
+	git_time_t since_date;
+	cl_git_pass(git_date_parse(&since_date,"2005-04-05"));
+	clone_opts.fetch_opts.shallow_since = since_date;
+	clone_opts.remote_cb = remote_single_branch;
+
+	git_str_joinpath(&path, clar_sandbox_path(), "shallowclone_old");
+
+	cl_git_pass(git_clone(
+	        &repo, "https://github.com/libgit2/TestGitRepository",
+	        git_str_cstr(&path), &clone_opts));
+
+	cl_assert_equal_b(false, git_repository_is_shallow(repo));
+
+	cl_git_pass(git_repository__shallow_roots(&roots, &roots_len, repo));
+	cl_assert_equal_i(0, roots_len);
+
+	git_revwalk_new(&walk, repo);
+
+	git_revwalk_push_head(walk);
+
+	while ((error = git_revwalk_next(&oid, walk)) == GIT_OK) {
+		num_commits++;
+	}
+
+	cl_assert_equal_i(num_commits, 21);
+	cl_assert_equal_i(error, GIT_ITEROVER);
+
+	git__free(roots);
+	git_str_dispose(&path);
+	git_revwalk_free(walk);
+	git_repository_free(repo);
+}
+
+void test_online_shallow__clone_since_midpoint(void)
+{
+	git_str path = GIT_STR_INIT;
+	git_repository *repo;
+	git_revwalk *walk;
+	git_clone_options clone_opts = GIT_CLONE_OPTIONS_INIT;
+	git_oid oid;
+	git_oid *roots;
+	size_t roots_len;
+	size_t num_commits = 0;
+	int error = 0;
+
+	/* Specify a date between the oldest and most recent commit. */
+	git_time_t since_date;
+	cl_git_pass(git_date_parse(&since_date, "2005-04-07 22:30:00 UTC"));
+	clone_opts.fetch_opts.shallow_since = since_date;
+	clone_opts.remote_cb = remote_single_branch;
+
+	git_str_joinpath(&path, clar_sandbox_path(), "shallowclone_midpoint");
+
+	cl_git_pass(git_clone(
+	        &repo, "https://github.com/libgit2/TestGitRepository",
+	        git_str_cstr(&path), &clone_opts));
+
+	cl_assert_equal_b(true, git_repository_is_shallow(repo));
+
+	cl_git_pass(git_repository__shallow_roots(&roots, &roots_len, repo));
+	cl_assert_equal_i(3, roots_len);
+	cl_assert_equal_s(
+	        "d0114ab8ac326bab30e3a657a0397578c5a1af88",
+	        git_oid_tostr_s(&roots[0]));
+	cl_assert_equal_s(
+	        "49322bb17d3acc9146f98c97d078513228bbf3c0",
+	        git_oid_tostr_s(&roots[1]));
+	cl_assert_equal_s(
+	        "f73b95671f326616d66b2afb3bdfcdbbce110b44",
+	        git_oid_tostr_s(&roots[2]));
+
+	git_revwalk_new(&walk, repo);
+
+	git_revwalk_push_head(walk);
+
+	while ((error = git_revwalk_next(&oid, walk)) == GIT_OK) {
+		num_commits++;
+	}
+
+	cl_assert_equal_i(num_commits, 1);
+	cl_assert_equal_i(error, GIT_ITEROVER);
+
+	git__free(roots);
+	git_str_dispose(&path);
+	git_revwalk_free(walk);
+	git_repository_free(repo);
+}
+
+void test_online_shallow__clone_since_recent(void)
+{
+	git_str path = GIT_STR_INIT;
+	git_repository *repo;
+	git_clone_options clone_opts = GIT_CLONE_OPTIONS_INIT;
+	size_t num_commits = 0;
+	int error = 0;
+
+	/* Specify a date newer than the most recent commit. */
+	git_time_t since_date;
+	cl_git_pass(git_date_parse(&since_date, "2025-04-07 22:30:00 UTC"));
+	clone_opts.fetch_opts.shallow_since = since_date;
+	clone_opts.remote_cb = remote_single_branch;
+
+	git_str_joinpath(&path, clar_sandbox_path(), "shallowclone_recent");
+
+	error = git_clone(
+	        &repo, "https://github.com/libgit2/TestGitRepository",
+	        git_str_cstr(&path), &clone_opts);
+
+	/* Command-line git gives a different (but no more useful) error in this
+	 * case - "error processing shallow info: 4". */
+	cl_assert_equal_i(error, GIT_EEOF);
+
+	git_str_dispose(&path);
+	git_repository_free(repo);
+}
+
 void test_online_shallow__unshallow(void)
 {
 	git_str path = GIT_STR_INIT;