thodg/libgit2/src/patch_parse.h

• Show log

  Commit

• Hash : ef1395f3
  Author :
  Date : 2017-11-11T15:30:43
  

  parse: extract parse module
  
  The `git_patch_parse_ctx` encapsulates both parser state as well as
  options specific to patch parsing. To advance this state and keep it
  consistent, we provide a few functions which handle advancing the
  current position and accessing bytes of the patch contents. In fact,
  these functions are quite generic and not related to patch-parsing by
  themselves. Seeing that we have similar logic inside of other modules,
  it becomes quite enticing to extract this functionality into its own
  parser module.
  
  To do so, we create a new module `parse` with a central struct called
  `git_parse_ctx`. It encapsulates both the content that is to be parsed
  as well as its lengths and the current position. `git_patch_parse_ctx`
  now only contains this `parse_ctx` only, which is then accessed whenever
  we need to touch the current parser. This is the first step towards
  re-using this functionality across other modules which require parsing
  functionality and remove code-duplication.
  

Download

• src/patch_parse.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_patch_parse_h__
  #define INCLUDE_patch_parse_h__
  
  #include "common.h"
  
  #include "parse.h"
  #include "patch.h"
  
  typedef struct {
  	git_refcount rc;
  
  	git_patch_options opts;
  
  	git_parse_ctx parse_ctx;
  } git_patch_parse_ctx;
  
  extern git_patch_parse_ctx *git_patch_parse_ctx_init(
  	const char *content,
  	size_t content_len,
  	const git_patch_options *opts);
  
  extern void git_patch_parse_ctx_free(git_patch_parse_ctx *ctx);
  
  /**
   * Create a patch for a single file from the contents of a patch buffer.
   *
   * @param out The patch to be created
   * @param contents The contents of a patch file
   * @param contents_len The length of the patch file
   * @param opts The git_patch_options
   * @return 0 on success, <0 on failure.
   */
  extern int git_patch_from_buffer(
  	git_patch **out,
  	const char *contents,
  	size_t contents_len,
  	const git_patch_options *opts);
  
  extern int git_patch_parse(
  	git_patch **out,
  	git_patch_parse_ctx *ctx);
  
  extern int git_patch_parsed_from_diff(git_patch **, git_diff *, size_t);
  
  #endif
  

Download