thodg/libgit2/src/remote.h

• Show log

  Commit

• Hash : 6fc6eeb6
  Author :
  Date : 2021-12-24T15:14:38
  

  remote: introduce `git_remote_connect_options` The existing mechanism for providing options to remote fetch/push calls, and subsequently to transports, is unsatisfactory. It requires an options structure to avoid breaking the API and callback signatures. 1. Introduce `git_remote_connect_options` to satisfy those needs. 2. Add a new remote connection API, `git_remote_connect_ext` that will take this new options structure. Existing `git_remote_connect` calls will proxy to that. `git_remote_fetch` and `git_remote_push` will proxy their fetch/push options to that as well. 3. Define the interaction between `git_remote_connect` and fetch/push. Connect _may_ be called before fetch/push, but _need not_ be. The semantics of which options would be used for these operations was not specified if you specify options for both connect _and_ fetch. Now these are defined that the fetch or push options will be used _if_ they were specified. Otherwise, the connect options will be used if they were specified. Otherwise, the library's defaults will be used. 4. Update the transports to understand `git_remote_connect_options`. This is a breaking change to the systems API.

Download

• src/remote.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_remote_h__
  #define INCLUDE_remote_h__
  
  #include "common.h"
  
  #include "git2/remote.h"
  #include "git2/transport.h"
  #include "git2/sys/transport.h"
  
  #include "refspec.h"
  #include "vector.h"
  #include "net.h"
  
  #define GIT_REMOTE_ORIGIN "origin"
  
  struct git_remote {
  	char *name;
  	char *url;
  	char *pushurl;
  	git_vector refs;
  	git_vector refspecs;
  	git_vector active_refspecs;
  	git_vector passive_refspecs;
  	git_transport *transport;
  	git_repository *repo;
  	git_push *push;
  	git_indexer_progress stats;
  	unsigned int need_pack;
  	git_remote_autotag_option_t download_tags;
  	int prune_refs;
  	int passed_refspecs;
  };
  
  int git_remote__urlfordirection(git_str *url_out, struct git_remote *remote, int direction, const git_remote_callbacks *callbacks);
  int git_remote__http_proxy(char **out, git_remote *remote, git_net_url *url);
  
  git_refspec *git_remote__matching_refspec(git_remote *remote, const char *refname);
  git_refspec *git_remote__matching_dst_refspec(git_remote *remote, const char *refname);
  
  int git_remote__default_branch(git_str *out, git_remote *remote);
  
  int git_remote_connect_options_dup(
  	git_remote_connect_options *dst,
  	const git_remote_connect_options *src);
  int git_remote_connect_options_normalize(
  	git_remote_connect_options *dst,
  	const git_remote_connect_options *src);
  void git_remote_connect_options_dispose(git_remote_connect_options *opts);
  
  #endif
  

Download