git-chopstick-core 0.1.1 → 0.1.3

package/{src/git/interpret-trailers.ts → dist/git/interpret-trailers.d.ts}

@@ -1,25 +1,18 @@
-import { git } from './core'
-import { Repository } from '../models/repository'
-import { getConfigValue } from './config'
-
+import { Repository } from '../models/repository.js';
 /**
  * A representation of a Git commit message trailer.
  *
  * See git-interpret-trailers for more information.
  */
 export interface ITrailer {
-  readonly token: string
-  readonly value: string
+    readonly token: string;
+    readonly value: string;
 }
-
 /**
  * Gets a value indicating whether the trailer token is
  * Co-Authored-By. Does not validate the token value.
  */
-export function isCoAuthoredByTrailer(trailer: ITrailer) {
-  return trailer.token.toLowerCase() === 'co-authored-by'
-}
-
+export declare function isCoAuthoredByTrailer(trailer: ITrailer): boolean;
 /**
  * Parse a string containing only unfolded trailers produced by
  * git-interpret-trailers --only-input --only-trailers --unfold or
@@ -35,49 +28,14 @@ export function isCoAuthoredByTrailer(trailer: ITrailer) {
  *
  *                   Also see getTrailerSeparatorCharacters.
  */
-export function parseRawUnfoldedTrailers(trailers: string, separators: string) {
-  const lines = trailers.split('\n')
-  const parsedTrailers = new Array<ITrailer>()
-
-  for (const line of lines) {
-    const trailer = parseSingleUnfoldedTrailer(line, separators)
-
-    if (trailer) {
-      parsedTrailers.push(trailer)
-    }
-  }
-
-  return parsedTrailers
-}
-
-export function parseSingleUnfoldedTrailer(
-  line: string,
-  separators: string
-): ITrailer | null {
-  for (const separator of separators) {
-    const ix = line.indexOf(separator)
-    if (ix > 0) {
-      return {
-        token: line.substring(0, ix).trim(),
-        value: line.substring(ix + 1).trim(),
-      }
-    }
-  }
-
-  return null
-}
-
+export declare function parseRawUnfoldedTrailers(trailers: string, separators: string): ITrailer[];
+export declare function parseSingleUnfoldedTrailer(line: string, separators: string): ITrailer | null;
 /**
  * Get a string containing the characters that may be used in this repository
  * separate tokens from values in commit message trailers. If no specific
  * trailer separator is configured the default separator (:) will be returned.
  */
-export async function getTrailerSeparatorCharacters(
-  repository: Repository
-): Promise<string> {
-  return (await getConfigValue(repository, 'trailer.separators')) || ':'
-}
-
+export declare function getTrailerSeparatorCharacters(repository: Repository): Promise<string>;
 /**
  * Extract commit message trailers from a commit message.
  *
@@ -97,29 +55,7 @@ export async function getTrailerSeparatorCharacters(
  *
  * @returns An array of zero or more parsed trailers
  */
-export async function parseTrailers(
-  repository: Repository,
-  commitMessage: string
-): Promise<ReadonlyArray<ITrailer>> {
-  const result = await git(
-    ['interpret-trailers', '--parse'],
-    repository.path,
-    'parseTrailers',
-    {
-      stdin: commitMessage,
-    }
-  )
-
-  const trailers = result.stdout
-
-  if (trailers.length === 0) {
-    return []
-  }
-
-  const separators = await getTrailerSeparatorCharacters(repository)
-  return parseRawUnfoldedTrailers(result.stdout, separators)
-}
-
+export declare function parseTrailers(repository: Repository, commitMessage: string): Promise<ReadonlyArray<ITrailer>>;
 /**
  * Merge one or more commit message trailers into a commit message.
  *
@@ -149,28 +85,4 @@ export async function parseTrailers(
  *                      configuration settings for trailers in the provided
  *                      repository.
  */
-export async function mergeTrailers(
-  repository: Repository,
-  commitMessage: string,
-  trailers: ReadonlyArray<ITrailer>,
-  unfold: boolean = false
-) {
-  const args = ['interpret-trailers']
-
-  // See https://github.com/git/git/blob/ebf3c04b262aa/Documentation/git-interpret-trailers.txt#L129-L132
-  args.push('--no-divider')
-
-  if (unfold) {
-    args.push('--unfold')
-  }
-
-  for (const trailer of trailers) {
-    args.push('--trailer', `${trailer.token}=${trailer.value}`)
-  }
-
-  const result = await git(args, repository.path, 'mergeTrailers', {
-    stdin: commitMessage,
-  })
-
-  return result.stdout
-}
+export declare function mergeTrailers(repository: Repository, commitMessage: string, trailers: ReadonlyArray<ITrailer>, unfold?: boolean): Promise<string>;

package/dist/git/interpret-trailers.js

@@ -0,0 +1,130 @@
+import { git } from './core.js';
+import { getConfigValue } from './config.js';
+/**
+ * Gets a value indicating whether the trailer token is
+ * Co-Authored-By. Does not validate the token value.
+ */
+export function isCoAuthoredByTrailer(trailer) {
+    return trailer.token.toLowerCase() === 'co-authored-by';
+}
+/**
+ * Parse a string containing only unfolded trailers produced by
+ * git-interpret-trailers --only-input --only-trailers --unfold or
+ * a derivative such as git log --format="%(trailers:only,unfold)"
+ *
+ * @param trailers   A string containing one well formed trailer per
+ *                   line
+ *
+ * @param separators A string containing all characters to use when
+ *                   attempting to find the separator between token
+ *                   and value in a trailer. See the configuration
+ *                   option trailer.separators for more information
+ *
+ *                   Also see getTrailerSeparatorCharacters.
+ */
+export function parseRawUnfoldedTrailers(trailers, separators) {
+    const lines = trailers.split('\n');
+    const parsedTrailers = new Array();
+    for (const line of lines) {
+        const trailer = parseSingleUnfoldedTrailer(line, separators);
+        if (trailer) {
+            parsedTrailers.push(trailer);
+        }
+    }
+    return parsedTrailers;
+}
+export function parseSingleUnfoldedTrailer(line, separators) {
+    for (const separator of separators) {
+        const ix = line.indexOf(separator);
+        if (ix > 0) {
+            return {
+                token: line.substring(0, ix).trim(),
+                value: line.substring(ix + 1).trim(),
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Get a string containing the characters that may be used in this repository
+ * separate tokens from values in commit message trailers. If no specific
+ * trailer separator is configured the default separator (:) will be returned.
+ */
+export async function getTrailerSeparatorCharacters(repository) {
+    return (await getConfigValue(repository, 'trailer.separators')) || ':';
+}
+/**
+ * Extract commit message trailers from a commit message.
+ *
+ * The trailers returned here are unfolded, i.e. they've had their
+ * whitespace continuation removed and are all on one line. See the
+ * documentation for --unfold in the help for `git interpret-trailers`
+ *
+ * @param repository    The repository in which to run the interpret-
+ *                      trailers command. Although not intuitive this
+ *                      does matter as there are configuration options
+ *                      available for the format, position, etc of commit
+ *                      message trailers. See the manpage for
+ *                      git-interpret-trailers for more information.
+ *
+ * @param commitMessage A commit message from where to attempt to extract
+ *                      commit message trailers.
+ *
+ * @returns An array of zero or more parsed trailers
+ */
+export async function parseTrailers(repository, commitMessage) {
+    const result = await git(['interpret-trailers', '--parse'], repository.path, 'parseTrailers', {
+        stdin: commitMessage,
+    });
+    const trailers = result.stdout;
+    if (trailers.length === 0) {
+        return [];
+    }
+    const separators = await getTrailerSeparatorCharacters(repository);
+    return parseRawUnfoldedTrailers(result.stdout, separators);
+}
+/**
+ * Merge one or more commit message trailers into a commit message.
+ *
+ * If no trailers are given this method will simply try to ensure that
+ * any trailers that happen to be part of the raw message are formatted
+ * in accordance with the configuration options set for trailers in
+ * the given repository.
+ *
+ * Note that configuration may be set so that duplicate trailers are
+ * kept or discarded.
+ *
+ * @param repository    The repository in which to run the interpret-
+ *                      trailers command. Although not intuitive this
+ *                      does matter as there are configuration options
+ *                      available for the format, position, etc of commit
+ *                      message trailers. See the manpage for
+ *                      git-interpret-trailers for more information.
+ *
+ * @param commitMessage A commit message with or without existing commit
+ *                      message trailers into which to merge the trailers
+ *                      given in the trailers parameter
+ *
+ * @param trailers      Zero or more trailers to merge into the commit message
+ *
+ * @returns             A commit message string where the provided trailers (if)
+ *                      any have been merged into the commit message using the
+ *                      configuration settings for trailers in the provided
+ *                      repository.
+ */
+export async function mergeTrailers(repository, commitMessage, trailers, unfold = false) {
+    const args = ['interpret-trailers'];
+    // See https://github.com/git/git/blob/ebf3c04b262aa/Documentation/git-interpret-trailers.txt#L129-L132
+    args.push('--no-divider');
+    if (unfold) {
+        args.push('--unfold');
+    }
+    for (const trailer of trailers) {
+        args.push('--trailer', `${trailer.token}=${trailer.value}`);
+    }
+    const result = await git(args, repository.path, 'mergeTrailers', {
+        stdin: commitMessage,
+    });
+    return result.stdout;
+}
+//# sourceMappingURL=interpret-trailers.js.map

package/dist/git/interpret-trailers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpret-trailers.js","sourceRoot":"","sources":["../../src/git/interpret-trailers.ts"],"names":[],"mappings":"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"}

package/dist/git/lfs.d.ts

@@ -0,0 +1,25 @@
+import { Repository } from '../models/repository.js';
+/** Install the global LFS filters. */
+export declare function installGlobalLFSFilters(force: boolean): Promise<void>;
+/** Install LFS hooks in the repository. */
+export declare function installLFSHooks(repository: Repository, force: boolean): Promise<void>;
+/** Is the repository configured to track any paths with LFS? */
+export declare function isUsingLFS(repository: Repository): Promise<boolean>;
+/**
+ * Check if a provided file path is being tracked by Git LFS
+ *
+ * This uses the Git plumbing to read the .gitattributes file
+ * for any LFS-related rules that are set for the file
+ *
+ * @param repository repository with
+ * @param path relative file path in the repository
+ */
+export declare function isTrackedByLFS(repository: Repository, path: string): Promise<boolean>;
+/**
+ * Query a Git repository and filter the set of provided relative paths to see
+ * which are not covered by the current Git LFS configuration.
+ *
+ * @param repository
+ * @param filePaths List of relative paths in the repository
+ */
+export declare function filesNotTrackedByLFS(repository: Repository, filePaths: ReadonlyArray<string>): Promise<ReadonlyArray<string>>;

package/dist/git/lfs.js

@@ -0,0 +1,73 @@
+import { git } from './core.js';
+/** Install the global LFS filters. */
+export async function installGlobalLFSFilters(force) {
+    const args = ['lfs', 'install', '--skip-repo'];
+    if (force) {
+        args.push('--force');
+    }
+    await git(args, __dirname, 'installGlobalLFSFilter');
+}
+/** Install LFS hooks in the repository. */
+export async function installLFSHooks(repository, force) {
+    const args = ['lfs', 'install'];
+    if (force) {
+        args.push('--force');
+    }
+    await git(args, repository.path, 'installLFSHooks');
+}
+/** Is the repository configured to track any paths with LFS? */
+export async function isUsingLFS(repository) {
+    const env = {
+        GIT_LFS_TRACK_NO_INSTALL_HOOKS: '1',
+    };
+    const result = await git(['lfs', 'track'], repository.path, 'isUsingLFS', {
+        env,
+    });
+    return result.stdout.length > 0;
+}
+/**
+ * Check if a provided file path is being tracked by Git LFS
+ *
+ * This uses the Git plumbing to read the .gitattributes file
+ * for any LFS-related rules that are set for the file
+ *
+ * @param repository repository with
+ * @param path relative file path in the repository
+ */
+export async function isTrackedByLFS(repository, path) {
+    const { stdout } = await git(['check-attr', 'filter', path], repository.path, 'checkAttrForLFS');
+    // "git check-attr -a" will output every filter it can find in .gitattributes
+    // and it looks like this:
+    //
+    // README.md: diff: lfs
+    // README.md: merge: lfs
+    // README.md: text: unset
+    // README.md: filter: lfs
+    //
+    // To verify git-lfs this test will just focus on that last row, "filter",
+    // and the value associated with it. If nothing is found in .gitattributes
+    // the output will look like this
+    //
+    // README.md: filter: unspecified
+    const lfsFilterRegex = /: filter: lfs/;
+    const match = lfsFilterRegex.exec(stdout);
+    return match !== null;
+}
+/**
+ * Query a Git repository and filter the set of provided relative paths to see
+ * which are not covered by the current Git LFS configuration.
+ *
+ * @param repository
+ * @param filePaths List of relative paths in the repository
+ */
+export async function filesNotTrackedByLFS(repository, filePaths) {
+    const filesNotTrackedByGitLFS = new Array();
+    for (const file of filePaths) {
+        const isTracked = await isTrackedByLFS(repository, file);
+        if (!isTracked) {
+            filesNotTrackedByGitLFS.push(file);
+        }
+    }
+    return filesNotTrackedByGitLFS;
+}
+//# sourceMappingURL=lfs.js.map

package/dist/git/lfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lfs.js","sourceRoot":"","sources":["../../src/git/lfs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAG/B,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAc;IAC1D,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;IAC9C,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IAED,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAA;AACtD,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAsB,EACtB,KAAc;IAEd,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IAC/B,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACtB,CAAC;IAED,MAAM,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;AACrD,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAsB;IACrD,MAAM,GAAG,GAAG;QACV,8BAA8B,EAAE,GAAG;KACpC,CAAA;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE;QACxE,GAAG;KACJ,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAsB,EACtB,IAAY;IAEZ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAC1B,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,EAC9B,UAAU,CAAC,IAAI,EACf,iBAAiB,CAClB,CAAA;IAED,6EAA6E;IAC7E,0BAA0B;IAC1B,EAAE;IACF,uBAAuB;IACvB,wBAAwB;IACxB,yBAAyB;IACzB,yBAAyB;IACzB,EAAE;IACF,0EAA0E;IAC1E,0EAA0E;IAC1E,iCAAiC;IACjC,EAAE;IACF,iCAAiC;IAEjC,MAAM,cAAc,GAAG,eAAe,CAAA;IAEtC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO,KAAK,KAAK,IAAI,CAAA;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAsB,EACtB,SAAgC;IAEhC,MAAM,uBAAuB,GAAG,IAAI,KAAK,EAAU,CAAA;IAEnD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAExD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED,OAAO,uBAAuB,CAAA;AAChC,CAAC"}

package/dist/git/log.d.ts

@@ -0,0 +1,56 @@
+import { CommittedFileChange } from '../models/status.js';
+import { Repository } from '../models/repository.js';
+import { Commit } from '../models/commit.js';
+import { CommitIdentity } from '../models/commit-identity.js';
+/**
+ * Get the repository's commits using `revisionRange` and limited to `limit`
+ */
+export declare function getCommits(repository: Repository, revisionRange?: string, limit?: number, skip?: number, additionalArgs?: ReadonlyArray<string>): Promise<ReadonlyArray<Commit>>;
+/** This interface contains information of a changeset. */
+export interface IChangesetData {
+    /** Files changed in the changeset. */
+    readonly files: ReadonlyArray<CommittedFileChange>;
+    /** Number of lines added in the changeset. */
+    readonly linesAdded: number;
+    /** Number of lines deleted in the changeset. */
+    readonly linesDeleted: number;
+}
+/** Get the files that were changed in the given commit. */
+export declare function getChangedFiles(repository: Repository, sha: string): Promise<IChangesetData>;
+/**
+ * Parses output of diff flags -z --raw --numstat.
+ *
+ * Given the -z flag the new lines are separated by \0 character (left them as
+ * new lines below for ease of reading)
+ *
+ * For modified, added, deleted, untracked:
+ *    100644 100644 5716ca5 db3c77d M
+ *    file_one_path
+ *    :100644 100644 0835e4f 28096ea M
+ *    file_two_path
+ *    1    0       file_one_path
+ *    1    0       file_two_path
+ *
+ * For copied or renamed:
+ *    100644 100644 5716ca5 db3c77d M
+ *    file_one_original_path
+ *    file_one_new_path
+ *    :100644 100644 0835e4f 28096ea M
+ *    file_two_original_path
+ *    file_two_new_path
+ *    1    0
+ *    file_one_original_path
+ *    file_one_new_path
+ *    1    0
+ *    file_two_original_path
+ *    file_two_new_path
+ */
+export declare function parseRawLogWithNumstat(stdout: string, sha: string, parentCommitish: string): {
+    files: CommittedFileChange[];
+    linesAdded: number;
+    linesDeleted: number;
+};
+/** Get the commit for the given ref. */
+export declare function getCommit(repository: Repository, ref: string): Promise<Commit | null>;
+/** Get the author identity for the given shas */
+export declare function getAuthors(repository: Repository, shas: string[]): Promise<CommitIdentity[]>;