1 /* Diff output generators and invocation shims. */
2 /*
3  * Copyright (c) 2020 Neels Hofmeyr <neels@hofmeyr.de>
4  *
5  * Permission to use, copy, modify, and distribute this software for any
6  * purpose with or without fee is hereby granted, provided that the above
7  * copyright notice and this permission notice appear in all copies.
8  *
9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16  */
17 
18 struct diff_input_info {
19 	const char *left_path;
20 	const char *right_path;
21 };
22 
23 struct diff_output_info {
24 	/*
25 	 * Byte offset to each line in the generated output file.
26 	 * The total number of lines in the file is line_offsets.len - 1.
27 	 * The last offset in this array corresponds to end-of-file.
28 	 */
29 	ARRAYLIST(off_t) line_offsets;
30 };
31 
32 void diff_output_info_free(struct diff_output_info *output_info);
33 
34 struct diff_chunk_context {
35 	struct diff_range chunk;
36 	struct diff_range left, right;
37 };
38 
39 int diff_output_plain(struct diff_output_info **output_info, FILE *dest,
40 			const struct diff_input_info *info,
41 			const struct diff_result *result);
42 int diff_output_unidiff(struct diff_output_info **output_info,
43 			FILE *dest, const struct diff_input_info *info,
44 			const struct diff_result *result,
45 			unsigned int context_lines);
46 int diff_output_edscript(struct diff_output_info **output_info,
47 			 FILE *dest, const struct diff_input_info *info,
48 			 const struct diff_result *result);
49 int diff_chunk_get_left_start(const struct diff_chunk *c,
50 			      const struct diff_result *r,
51 			      int context_lines);
52 int diff_chunk_get_left_end(const struct diff_chunk *c,
53 			    const struct diff_result *r,
54 			    int context_lines);
55 int diff_chunk_get_right_start(const struct diff_chunk *c,
56 			       const struct diff_result *r,
57 			       int context_lines);
58 int diff_chunk_get_right_end(const struct diff_chunk *c,
59 			     const struct diff_result *r,
60 			     int context_lines);
61 void diff_chunk_context_get(struct diff_chunk_context *cc,
62 				 const struct diff_result *r,
63 				 int chunk_idx, int context_lines);
64 struct diff_output_unidiff_state;
65 struct diff_output_unidiff_state *diff_output_unidiff_state_alloc(void);
66 void diff_output_unidiff_state_reset(struct diff_output_unidiff_state *state);
67 void diff_output_unidiff_state_free(struct diff_output_unidiff_state *state);
68 int diff_output_unidiff_chunk(struct diff_output_info **output_info, FILE *dest,
69 			  struct diff_output_unidiff_state *state,
70 			  const struct diff_input_info *info,
71 			  const struct diff_result *result,
72 			  const struct diff_chunk_context *cc);
73 int diff_output_chunk_left_version(struct diff_output_info **output_info,
74 			       FILE *dest,
75 			       const struct diff_input_info *info,
76 			       const struct diff_result *result,
77 			       const struct diff_chunk_context *cc);
78 int diff_output_chunk_right_version(struct diff_output_info **output_info,
79 				FILE *dest,
80 				const struct diff_input_info *info,
81 				const struct diff_result *result,
82 				const struct diff_chunk_context *cc);