DefinitelyTyped/types/nodegit/diff.d.ts

import { Blob } from './blob';
import { Repository } from './repository';
import { Tree } from './tree';
import { Strarray } from './str-array';
import { Index } from './index_';
import { DiffDelta } from './diff-delta';
import { DiffPerfdata } from './diff-perf-data';
import { DiffOptions } from './diff-options';
import { Buf } from './buf';

export interface DiffFindOptions {
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    version?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    flags?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    renameThreshold?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    renameFromRewriteThreshold?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    copyThreshold?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    breakRewriteThreshold?: number;
    /**
     *
     *
     * @type {number}
     * @memberof DiffFindOptions
     */
    renameLimit?: number;
}

export namespace Diff {
    const enum DELTA {
        UNMODIFIED = 0,
        ADDED = 1,
        DELETED = 2,
        MODIFIED = 3,
        RENAMED = 4,
        COPIED = 5,
        IGNORED = 6,
        UNTRACKED = 7,
        TYPECHANGE = 8,
        UNREADABLE = 9,
        CONFLICTED = 10
    }

    const enum FIND {
        BY_CONFIG = 0,
        RENAMES = 1,
        RENAMES_FROM_REWRITES = 2,
        COPIES = 4,
        COPIES_FROM_UNMODIFIED = 8,
        REWRITES = 16,
        BREAK_REWRITES = 32,
        AND_BREAK_REWRITES = 48,
        FOR_UNTRACKED = 64,
        ALL = 255,
        IGNORE_LEADING_WHITESPACE = 0,
        IGNORE_WHITESPACE = 4096,
        DONT_IGNORE_WHITESPACE = 8192,
        EXACT_MATCH_ONLY = 16384,
        BREAK_REWRITES_FOR_RENAMES_ONLY = 32768,
        REMOVE_UNMODIFIED = 65536
    }

    const enum FLAG {
        BINARY = 1,
        NOT_BINARY = 2,
        VALID_ID = 4,
        EXISTS = 8
    }

    const enum FORMAT {
        PATCH = 1,
        PATCH_HEADER = 2,
        RAW = 3,
        NAME_ONLY = 4,
        NAME_STATUS = 5
    }

    const enum FORMAT_EMAIL_FLAGS {
        FORMAT_EMAIL_NONE = 0,
        FORMAT_EMAIL_EXCLUDE_SUBJECT_PATCH_MARKER = 1
    }

    const enum LINE {
        CONTEXT = 32,
        ADDITION = 43,
        DELETION = 45,
        CONTEXT_EOFNL = 61,
        ADD_EOFNL = 62,
        DEL_EOFNL = 60,
        FILE_HDR = 70,
        HUNK_HDR = 72,
        BINARY = 66
    }

    const enum OPTION {
        NORMAL = 0,
        REVERSE = 1,
        INCLUDE_IGNORED = 2,
        RECURSE_IGNORED_DIRS = 4,
        INCLUDE_UNTRACKED = 8,
        RECURSE_UNTRACKED_DIRS = 16,
        INCLUDE_UNMODIFIED = 32,
        INCLUDE_TYPECHANGE = 64,
        INCLUDE_TYPECHANGE_TREES = 128,
        IGNORE_FILEMODE = 256,
        IGNORE_SUBMODULES = 512,
        IGNORE_CASE = 1024,
        INCLUDE_CASECHANGE = 2048,
        DISABLE_PATHSPEC_MATCH = 4096,
        SKIP_BINARY_CHECK = 8192,
        ENABLE_FAST_UNTRACKED_DIRS = 16384,
        UPDATE_INDEX = 32768,
        INCLUDE_UNREADABLE = 65536,
        INCLUDE_UNREADABLE_AS_UNTRACKED = 131072,
        FORCE_TEXT = 1048576,
        FORCE_BINARY = 2097152,
        IGNORE_WHITESPACE = 4194304,
        IGNORE_WHITESPACE_CHANGE = 8388608,
        IGNORE_WHITESPACE_EOL = 16777216,
        SHOW_UNTRACKED_CONTENT = 33554432,
        SHOW_UNMODIFIED = 67108864,
        PATIENCE = 268435456,
        MINIMAL = 536870912,
        SHOW_BINARY = 1073741824
    }

    const enum STATS_FORMAT {
        STATS_NONE = 0,
        STATS_FULL = 1,
        STATS_SHORT = 2,
        STATS_NUMBER = 4,
        STATS_INCLUDE_SUMMARY = 8
    }
}

export class Diff {
    /**
     * Directly run a diff between a blob and a buffer.
     *
     * @static
     * @param {Blob} old_blob
     * @param {string} oldAsPath
     * @param {string} buffer
     * @param {string} bufferAsPath
     * @param {DiffOptions} opts
     * @param {Function} fileCb
     * @param {Function} binaryCb
     * @param {Function} hunkCb
     * @param {Function} lineCb
     * @returns {Promise<any>}
     *
     * @memberof Diff
     */
    static blobToBuffer(old_blob: Blob, oldAsPath: string,
        buffer: string, bufferAsPath: string, opts: DiffOptions, fileCb: Function, binaryCb: Function, hunkCb: Function, lineCb: Function): Promise<any>;
    /**
     *
     *
     * @static
     * @param {string} content
     * @param {number} contentLen
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static fromBuffer(content: string, contentLen: number): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Index} index
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static indexToWorkdir(repo: Repository, index: Index, opts: DiffOptions): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Index} oldIndex
     * @param {Index} newIndex
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static indexToIndex(repo: Repository, oldIndex: Index, newIndex: Index, opts: DiffOptions): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Tree} old_tree
     * @param {Index} index
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static treeToIndex(repo: Repository, old_tree: Tree, index: Index, opts: DiffOptions): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Tree} old_tree
     * @param {Tree} new_tree
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static treeToTree(repo: Repository, old_tree: Tree, new_tree: Tree, opts: DiffOptions): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Tree} old_tree
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static treeToWorkdir(repo: Repository, old_tree: Tree, opts: DiffOptions): Promise<Diff>;
    /**
     *
     *
     * @static
     * @param {Repository} repo
     * @param {Tree} old_tree
     * @param {DiffOptions} opts
     * @returns {Promise<Diff>}
     *
     * @memberof Diff
     */
    static treeToWorkdirWithIndex(repo: Repository, old_tree: Tree, opts: DiffOptions): Promise<Diff>;

    /**
     *
     *
     * @param {DiffFindOptions} options
     * @returns {Promise<number>}
     *
     * @memberof Diff
     */
    findSimilar(options: DiffFindOptions): Promise<number>;
    /**
     *
     *
     * @param {number} idx
     * @returns {DiffDelta}
     *
     * @memberof Diff
     */
    getDelta(idx: number): DiffDelta;
    /**
     *
     *
     * @returns {Promise<DiffPerfdata>}
     *
     * @memberof Diff
     */
    getPerfdata(): Promise<DiffPerfdata>;
    /**
     *
     *
     * @returns {number}
     *
     * @memberof Diff
     */
    numDeltas(): number;
    /**
     * Retrieve patches in this difflist
     *
     * @returns {Promise<any[]>}
     *
     * @memberof Diff
     */
    patches(): Promise<any[]>;
    /**
     *
     *
     * @param {Diff} from
     * @returns {Promise<number>}
     *
     * @memberof Diff
     */
    merge(from: Diff): Promise<number>;
    /**
     *
     *
     * @param {Diff.FORMAT} format
     * @returns {Promise<Buf>}
     *
     * @memberof Diff
     */
    toBuf(format: Diff.FORMAT): Promise<Buf>;
}