Merge branch of github.com:alshopov/git-po into master
[git/raj.git] / sequencer.h
blob718a07426dae930dc07417f902fa1ad5682eb337
1 #ifndef SEQUENCER_H
2 #define SEQUENCER_H
4 #include "cache.h"
5 #include "strbuf.h"
7 struct commit;
8 struct repository;
10 const char *git_path_commit_editmsg(void);
11 const char *git_path_seq_dir(void);
12 const char *rebase_path_todo(void);
13 const char *rebase_path_todo_backup(void);
14 const char *rebase_path_dropped(void);
16 #define APPEND_SIGNOFF_DEDUP (1u << 0)
18 enum replay_action {
19 REPLAY_REVERT,
20 REPLAY_PICK,
21 REPLAY_INTERACTIVE_REBASE
24 enum commit_msg_cleanup_mode {
25 COMMIT_MSG_CLEANUP_SPACE,
26 COMMIT_MSG_CLEANUP_NONE,
27 COMMIT_MSG_CLEANUP_SCISSORS,
28 COMMIT_MSG_CLEANUP_ALL
31 struct replay_opts {
32 enum replay_action action;
34 /* Boolean options */
35 int edit;
36 int record_origin;
37 int no_commit;
38 int signoff;
39 int allow_ff;
40 int allow_rerere_auto;
41 int allow_empty;
42 int allow_empty_message;
43 int drop_redundant_commits;
44 int keep_redundant_commits;
45 int verbose;
46 int quiet;
47 int reschedule_failed_exec;
49 int mainline;
51 char *gpg_sign;
52 enum commit_msg_cleanup_mode default_msg_cleanup;
53 int explicit_cleanup;
55 /* Merge strategy */
56 char *strategy;
57 char **xopts;
58 size_t xopts_nr, xopts_alloc;
60 /* Used by fixup/squash */
61 struct strbuf current_fixups;
62 int current_fixup_count;
64 /* placeholder commit for -i --root */
65 struct object_id squash_onto;
66 int have_squash_onto;
68 /* Only used by REPLAY_NONE */
69 struct rev_info *revs;
71 #define REPLAY_OPTS_INIT { .action = -1, .current_fixups = STRBUF_INIT }
74 * Note that ordering matters in this enum. Not only must it match the mapping
75 * of todo_command_info (in sequencer.c), it is also divided into several
76 * sections that matter. When adding new commands, make sure you add it in the
77 * right section.
79 enum todo_command {
80 /* commands that handle commits */
81 TODO_PICK = 0,
82 TODO_REVERT,
83 TODO_EDIT,
84 TODO_REWORD,
85 TODO_FIXUP,
86 TODO_SQUASH,
87 /* commands that do something else than handling a single commit */
88 TODO_EXEC,
89 TODO_BREAK,
90 TODO_LABEL,
91 TODO_RESET,
92 TODO_MERGE,
93 /* commands that do nothing but are counted for reporting progress */
94 TODO_NOOP,
95 TODO_DROP,
96 /* comments (not counted for reporting progress) */
97 TODO_COMMENT
100 struct todo_item {
101 enum todo_command command;
102 struct commit *commit;
103 unsigned int flags;
104 int arg_len;
105 /* The offset of the command and its argument in the strbuf */
106 size_t offset_in_buf, arg_offset;
109 struct todo_list {
110 struct strbuf buf;
111 struct todo_item *items;
112 int nr, alloc, current;
113 int done_nr, total_nr;
114 struct stat_data stat;
117 #define TODO_LIST_INIT { STRBUF_INIT }
119 int todo_list_parse_insn_buffer(struct repository *r, char *buf,
120 struct todo_list *todo_list);
121 int todo_list_write_to_file(struct repository *r, struct todo_list *todo_list,
122 const char *file, const char *shortrevisions,
123 const char *shortonto, int num, unsigned flags);
124 void todo_list_release(struct todo_list *todo_list);
125 const char *todo_item_get_arg(struct todo_list *todo_list,
126 struct todo_item *item);
128 /* Call this to setup defaults before parsing command line options */
129 void sequencer_init_config(struct replay_opts *opts);
130 int sequencer_pick_revisions(struct repository *repo,
131 struct replay_opts *opts);
132 int sequencer_continue(struct repository *repo, struct replay_opts *opts);
133 int sequencer_rollback(struct repository *repo, struct replay_opts *opts);
134 int sequencer_skip(struct repository *repo, struct replay_opts *opts);
135 int sequencer_remove_state(struct replay_opts *opts);
137 /* #define TODO_LIST_KEEP_EMPTY (1U << 0) */ /* No longer used */
138 #define TODO_LIST_SHORTEN_IDS (1U << 1)
139 #define TODO_LIST_ABBREVIATE_CMDS (1U << 2)
140 #define TODO_LIST_REBASE_MERGES (1U << 3)
142 * When rebasing merges, commits that do have the base commit as ancestor
143 * ("cousins") are *not* rebased onto the new base by default. If those
144 * commits should be rebased onto the new base, this flag needs to be passed.
146 #define TODO_LIST_REBASE_COUSINS (1U << 4)
147 #define TODO_LIST_APPEND_TODO_HELP (1U << 5)
149 * When generating a script that rebases merges with `--root` *and* with
150 * `--onto`, we do not want to re-generate the root commits.
152 #define TODO_LIST_ROOT_WITH_ONTO (1U << 6)
155 int sequencer_make_script(struct repository *r, struct strbuf *out, int argc,
156 const char **argv, unsigned flags);
158 void todo_list_add_exec_commands(struct todo_list *todo_list,
159 struct string_list *commands);
160 int complete_action(struct repository *r, struct replay_opts *opts, unsigned flags,
161 const char *shortrevisions, const char *onto_name,
162 struct commit *onto, const char *orig_head, struct string_list *commands,
163 unsigned autosquash, struct todo_list *todo_list);
164 int todo_list_rearrange_squash(struct todo_list *todo_list);
167 * Append a signoff to the commit message in "msgbuf". The ignore_footer
168 * parameter specifies the number of bytes at the end of msgbuf that should
169 * not be considered at all. I.e., they are not checked for existing trailers,
170 * and the new signoff will be spliced into the buffer before those bytes.
172 void append_signoff(struct strbuf *msgbuf, size_t ignore_footer, unsigned flag);
174 void append_conflicts_hint(struct index_state *istate,
175 struct strbuf *msgbuf, enum commit_msg_cleanup_mode cleanup_mode);
176 enum commit_msg_cleanup_mode get_cleanup_mode(const char *cleanup_arg,
177 int use_editor);
179 void cleanup_message(struct strbuf *msgbuf,
180 enum commit_msg_cleanup_mode cleanup_mode, int verbose);
182 int message_is_empty(const struct strbuf *sb,
183 enum commit_msg_cleanup_mode cleanup_mode);
184 int template_untouched(const struct strbuf *sb, const char *template_file,
185 enum commit_msg_cleanup_mode cleanup_mode);
186 int update_head_with_reflog(const struct commit *old_head,
187 const struct object_id *new_head,
188 const char *action, const struct strbuf *msg,
189 struct strbuf *err);
190 void commit_post_rewrite(struct repository *r,
191 const struct commit *current_head,
192 const struct object_id *new_head);
194 #define SUMMARY_INITIAL_COMMIT (1 << 0)
195 #define SUMMARY_SHOW_AUTHOR_DATE (1 << 1)
196 void print_commit_summary(struct repository *repo,
197 const char *prefix,
198 const struct object_id *oid,
199 unsigned int flags);
201 int read_author_script(const char *path, char **name, char **email, char **date,
202 int allow_missing);
203 void parse_strategy_opts(struct replay_opts *opts, char *raw_opts);
204 int write_basic_state(struct replay_opts *opts, const char *head_name,
205 struct commit *onto, const char *orig_head);
206 void sequencer_post_commit_cleanup(struct repository *r, int verbose);
207 int sequencer_get_last_command(struct repository* r,
208 enum replay_action *action);
209 #endif /* SEQUENCER_H */