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