thodg/libgit2/src/refs.h

• Show log

  Commit

• Hash : 92dac975
  Author :
  Date : 2013-10-08T16:35:57
  

  Make reference lookups apply precomposeunicode
  
  Before these changes, looking up a reference would return the
  same precomposed or decomposed form of the reference name that
  was used to look it up, so on MacOS which ignores the difference
  between the two, a single reference could be looked up either way
  and git_reference_name would return the form of the name that was
  used to look it up!  This change makes lookup always return the
  precomposed name if core.precomposeunicode is set regardless of
  which version was used to look it up.  The reference iterator was
  already returning the precomposed form from earlier work.
  
  This also updates the CMakeLists.txt rules for enabling iconv
  usage because the clar tests for this code were actually not being
  activated properly with the old version.
  
  Finally, this moves git_repository_reset_filesystem from include/
  git2/repository.h to include/git2/sys/repository.h since it is not
  really a function that normal library users should have to think
  about very often.
  

Download

• src/refs.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_refs_h__
  #define INCLUDE_refs_h__
  
  #include "common.h"
  #include "git2/oid.h"
  #include "git2/refs.h"
  #include "git2/refdb.h"
  #include "strmap.h"
  #include "buffer.h"
  #include "oid.h"
  
  #define GIT_REFS_DIR "refs/"
  #define GIT_REFS_HEADS_DIR GIT_REFS_DIR "heads/"
  #define GIT_REFS_TAGS_DIR GIT_REFS_DIR "tags/"
  #define GIT_REFS_REMOTES_DIR GIT_REFS_DIR "remotes/"
  #define GIT_REFS_DIR_MODE 0777
  #define GIT_REFS_FILE_MODE 0666
  
  #define GIT_RENAMED_REF_FILE GIT_REFS_DIR "RENAMED-REF"
  
  #define GIT_SYMREF "ref: "
  #define GIT_PACKEDREFS_FILE "packed-refs"
  #define GIT_PACKEDREFS_HEADER "# pack-refs with: peeled fully-peeled "
  #define GIT_PACKEDREFS_FILE_MODE 0666
  
  #define GIT_HEAD_FILE "HEAD"
  #define GIT_ORIG_HEAD_FILE "ORIG_HEAD"
  #define GIT_FETCH_HEAD_FILE "FETCH_HEAD"
  #define GIT_MERGE_HEAD_FILE "MERGE_HEAD"
  #define GIT_REVERT_HEAD_FILE "REVERT_HEAD"
  #define GIT_CHERRY_PICK_HEAD_FILE "CHERRY_PICK_HEAD"
  #define GIT_BISECT_LOG_FILE "BISECT_LOG"
  #define GIT_REBASE_MERGE_DIR "rebase-merge/"
  #define GIT_REBASE_MERGE_INTERACTIVE_FILE GIT_REBASE_MERGE_DIR "interactive"
  #define GIT_REBASE_APPLY_DIR "rebase-apply/"
  #define GIT_REBASE_APPLY_REBASING_FILE GIT_REBASE_APPLY_DIR "rebasing"
  #define GIT_REBASE_APPLY_APPLYING_FILE GIT_REBASE_APPLY_DIR "applying"
  #define GIT_REFS_HEADS_MASTER_FILE GIT_REFS_HEADS_DIR "master"
  
  #define GIT_STASH_FILE "stash"
  #define GIT_REFS_STASH_FILE GIT_REFS_DIR GIT_STASH_FILE
  
  #define GIT_REF_FORMAT__PRECOMPOSE_UNICODE	(1u << 16)
  
  #define GIT_REFNAME_MAX 1024
  
  struct git_reference {
  	git_refdb *db;
  	git_ref_t type;
  
  	union {
  		git_oid oid;
  		char *symbolic;
  	} target;
  
  	git_oid peel;
  	char name[0];
  };
  
  git_reference *git_reference__set_name(git_reference *ref, const char *name);
  
  int git_reference__normalize_name_lax(char *buffer_out, size_t out_size, const char *name);
  int git_reference__normalize_name(git_buf *buf, const char *name, unsigned int flags);
  int git_reference__update_terminal(git_repository *repo, const char *ref_name, const git_oid *oid);
  int git_reference__is_valid_name(const char *refname, unsigned int flags);
  int git_reference__is_branch(const char *ref_name);
  int git_reference__is_remote(const char *ref_name);
  int git_reference__is_tag(const char *ref_name);
  
  /**
   * Lookup a reference by name and try to resolve to an OID.
   *
   * You can control how many dereferences this will attempt to resolve the
   * reference with the `max_deref` parameter, or pass -1 to use a sane
   * default.  If you pass 0 for `max_deref`, this will not attempt to resolve
   * the reference.  For any value of `max_deref` other than 0, not
   * successfully resolving the reference will be reported as an error.
  
   * The generated reference must be freed by the user.
   *
   * @param reference_out Pointer to the looked-up reference
   * @param repo The repository to look up the reference
   * @param name The long name for the reference (e.g. HEAD, ref/heads/master, refs/tags/v0.1.0, ...)
   * @param max_deref Maximum number of dereferences to make of symbolic refs, 0 means simple lookup, < 0 means use default reasonable value
   * @return 0 on success or < 0 on error; not being able to resolve the reference is an error unless 0 was passed for max_deref
   */
  int git_reference_lookup_resolved(
  	git_reference **reference_out,
  	git_repository *repo,
  	const char *name,
  	int max_deref);
  
  #endif
  

Download