thodg/libgit2/src/repository.h

• Show log

  Commit

• Hash : 5540d947
  Author :
  Date : 2013-03-15T16:39:00
  

  Implement global/system file search paths The goal of this work is to expose the search logic for "global", "system", and "xdg" files through the git_libgit2_opts() interface. Behind the scenes, I changed the logic for finding files to have a notion of a git_strarray that represents a search path and to store a separate search path for each of the three tiers of config file. For each tier, I implemented a function to initialize it to default values (generally based on environment variables), and then general interfaces to get it, set it, reset it, and prepend new directories to it. Next, I exposed these interfaces through the git_libgit2_opts interface, reusing the GIT_CONFIG_LEVEL_SYSTEM, etc., constants for the user to control which search path they were modifying. There are alternative designs for the opts interface / argument ordering, so I'm putting this phase out for discussion. Additionally, I ended up doing a little bit of clean up regarding attr.h and attr_file.h, adding a new attrcache.h so the other two files wouldn't have to be included in so many places.

Download

• src/repository.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_repository_h__
  #define INCLUDE_repository_h__
  
  #include "git2/common.h"
  #include "git2/oid.h"
  #include "git2/odb.h"
  #include "git2/repository.h"
  #include "git2/object.h"
  
  #include "index.h"
  #include "cache.h"
  #include "refs.h"
  #include "buffer.h"
  #include "odb.h"
  #include "object.h"
  #include "attrcache.h"
  #include "strmap.h"
  #include "refdb.h"
  
  #define DOT_GIT ".git"
  #define GIT_DIR DOT_GIT "/"
  #define GIT_DIR_MODE 0755
  #define GIT_BARE_DIR_MODE 0777
  
  /** Cvar cache identifiers */
  typedef enum {
  	GIT_CVAR_AUTO_CRLF = 0, /* core.autocrlf */
  	GIT_CVAR_EOL, /* core.eol */
  	GIT_CVAR_CACHE_MAX
  } git_cvar_cached;
  
  /**
   * CVAR value enumerations
   *
   * These are the values that are actually stored in the cvar cache, instead
   * of their string equivalents. These values are internal and symbolic;
   * make sure that none of them is set to `-1`, since that is the unique
   * identifier for "not cached"
   */
  typedef enum {
  	/* The value hasn't been loaded from the cache yet */
  	GIT_CVAR_NOT_CACHED = -1,
  
  	/* core.safecrlf: false, 'fail', 'warn' */
  	GIT_SAFE_CRLF_FALSE = 0,
  	GIT_SAFE_CRLF_FAIL = 1,
  	GIT_SAFE_CRLF_WARN = 2,
  
  	/* core.autocrlf: false, true, 'input; */
  	GIT_AUTO_CRLF_FALSE = 0,
  	GIT_AUTO_CRLF_TRUE = 1,
  	GIT_AUTO_CRLF_INPUT = 2,
  	GIT_AUTO_CRLF_DEFAULT = GIT_AUTO_CRLF_FALSE,
  
  	/* core.eol: unset, 'crlf', 'lf', 'native' */
  	GIT_EOL_UNSET = 0,
  	GIT_EOL_CRLF = 1,
  	GIT_EOL_LF = 2,
  #ifdef GIT_WIN32
  	GIT_EOL_NATIVE = GIT_EOL_CRLF,
  #else
  	GIT_EOL_NATIVE = GIT_EOL_LF,
  #endif
  	GIT_EOL_DEFAULT = GIT_EOL_NATIVE
  } git_cvar_value;
  
  /* internal repository init flags */
  enum {
  	GIT_REPOSITORY_INIT__HAS_DOTGIT = (1u << 16),
  	GIT_REPOSITORY_INIT__NATURAL_WD = (1u << 17),
  	GIT_REPOSITORY_INIT__IS_REINIT  = (1u << 18),
  };
  
  /** Internal structure for repository object */
  struct git_repository {
  	git_odb *_odb;
  	git_refdb *_refdb;
  	git_config *_config;
  	git_index *_index;
  
  	git_cache objects;
  	git_attr_cache attrcache;
  	git_strmap *submodules;
  
  	char *path_repository;
  	char *workdir;
  
  	unsigned is_bare:1;
  	unsigned int lru_counter;
  
  	git_cvar_value cvar_cache[GIT_CVAR_CACHE_MAX];
  };
  
  GIT_INLINE(git_attr_cache *) git_repository_attr_cache(git_repository *repo)
  {
  	return &repo->attrcache;
  }
  
  int git_repository_head_tree(git_tree **tree, git_repository *repo);
  
  /*
   * Weak pointers to repository internals.
   *
   * The returned pointers do not need to be freed. Do not keep
   * permanent references to these (i.e. between API calls), since they may
   * become invalidated if the user replaces a repository internal.
   */
  int git_repository_config__weakptr(git_config **out, git_repository *repo);
  int git_repository_odb__weakptr(git_odb **out, git_repository *repo);
  int git_repository_refdb__weakptr(git_refdb **out, git_repository *repo);
  int git_repository_index__weakptr(git_index **out, git_repository *repo);
  
  /*
   * CVAR cache
   *
   * Efficient access to the most used config variables of a repository.
   * The cache is cleared everytime the config backend is replaced.
   */
  int git_repository__cvar(int *out, git_repository *repo, git_cvar_cached cvar);
  void git_repository__cvar_cache_clear(git_repository *repo);
  
  /*
   * Submodule cache
   */
  extern void git_submodule_config_free(git_repository *repo);
  
  GIT_INLINE(int) git_repository__ensure_not_bare(
  	git_repository *repo,
  	const char *operation_name)
  {
  	if (!git_repository_is_bare(repo))
  		return 0;
  
  	giterr_set(
  		GITERR_REPOSITORY,
  		"Cannot %s. This operation is not allowed against bare repositories.",
  		operation_name);
  
  	return GIT_EBAREREPO;
  }
  
  #endif
  

Download