thodg/libgit2/src/git/commit.h

• Show log

  Commit

• Hash : 417f0abc
  Author :
  Date : 2010-05-14T18:44:49
  

  Add basic functionality for commit lookup/parsing
  
  The external API function "git_commit_parse" has been renamed
  to "git_commit_lookup" and has been partially implemented with
  support for loading commits straight from the ODB. It still lacks
  the functionality to lookup cached commits in the revpool and to
  resolve tags to commits.
  
  The following internal functions have been partially implemented:
  
  int git_commit__parse_buffer(...);
  int git_commit__parse_time(...);
  int git_commit__parse_oid(...);
  
  Commits are now fully parsed but the generated parent and tree
  references are not handled yet.
  
  Signed-off-by: Vicent Marti <tanoku@gmail.com>
  Signed-off-by: Andreas Ericsson <ae@op5.se>
  

Download

• src/git/commit.h

• #ifndef INCLUDE_git_commit_h__
  #define INCLUDE_git_commit_h__
  
  #include "common.h"
  #include "oid.h"
  
  /**
   * @file git/commit.h
   * @brief Git commit parsing, formatting routines
   * @defgroup git_commit Git commit parsing, formatting routines
   * @ingroup Git
   * @{
   */
  GIT_BEGIN_DECL
  
  /** Parsed representation of a commit object. */
  typedef struct git_commit git_commit;
  
  /**
   * Locate a reference to a commit without loading it.
   * @param pool the pool to use when locating the commit.
   * @param id identity of the commit to locate.  If the object is
   *        an annotated tag it will be peeled back to the commit.
   * @return the commit; NULL if the commit could not be created
   */
  GIT_EXTERN(git_commit *) git_commit_lookup(git_revpool *pool, const git_oid *id);
  
  /**
   * Locate a reference to a commit, and try to load and parse it it from
   * the commit cache or the object database.
   * @param pool the pool to use when parsing/caching the commit.
   * @param id identity of the commit to locate.  If the object is
   *        an annotated tag it will be peeled back to the commit.
   * @return the commit; NULL if the commit does not exist in the
   *         pool's git_odb, or if the commit is present but is
   *         too malformed to be parsed successfully.
   */
  GIT_EXTERN(git_commit *) git_commit_parse(git_revpool *pool, const git_oid *id);
  
  /**
   * Get the id of a commit.
   * @param commit a previously parsed commit.
   * @return object identity for the commit.
   */
  GIT_EXTERN(const git_oid *) git_commit_id(git_commit *commit);
  
  /** @} */
  GIT_END_DECL
  #endif
  

Download