jamiemason / logservable

git log as an observable stream of JSON

logservable

git log as an observable stream of JSON.

Table of Contents

• 🌩 Installation
• 📝 API
• 🙋🏿‍♀️ Getting Help
• 👀 Other Projects
• 🤓 Author

🌩 Installation

npm install --save logservable

📝 API

logservable.commits

logservable.commits returns an RxJS Observable which takes an RxJS Observer;

import { commits } from "logservable";
import { take } from "rxjs/operators";

const commit$ = commits("/Users/foldleft/Dev/my-project", {
  fieldNames: ["authorDateRelative", "authorName", "commitHash"],
  oldestFirst: false
});

commit$.pipe(take(3)).subscribe({
  next(commit) {
    console.log(
      "%s committed %s %s",
      commit.authorName,
      commit.commitHash,
      commit.authorDateRelative
    );
  },
  error(err) {
    console.error("The Stream gave me an error: ", err);
  },
  complete() {
    console.log("The Stream told me it is done.");
  }
});

Our example would produce;

Guybrush Threepwood committed ad7b84e54c62809c7d46b9bb77087a007d1967b5 2 hours ago
Elaine Marley committed 12c1cde06cdca28d9b41c9cdf667b3e4ff894ca1 2 hours ago
Herman Toothrot committed 60121fda22cd43a04716c8a76fa803bf1a81e217 6 hours ago
The Stream told me it is done.

Arguments

directory:String

Absolute path to your locally cloned git repository.

options.fieldNames:String[]

Optional array of strings representing the data required from each git commit (defaults to all).

authorDate
authorDateRelative
authorEmail
authorName
body
commitHash
commitNotes
committerDate
committerDateRelative
committerEmail
committerName
parentHashes
reflogIdentityEmail
reflogIdentityName
reflogSelector
reflogSubject
sanitizedSubjectLine
subject
treeHash

For more information see the Git Pretty Formats Documentation.

options.oldestFirst:Boolean

Whether to read the commits in order of oldest to newest (defaults to false).

options.skipMergeCommits:Boolean

Whether to exclude merge commits from being returned (defaults to true).

logservable.tags

logservable.tags returns an RxJS Observable which takes an RxJS Observer;

import { tags } from "logservable";
import { take } from "rxjs/operators";

const tag$ = tags("/Users/foldleft/Dev/my-project");

tag$.pipe(take(3)).subscribe({
  next(tag) {
    console.log("commit %s is tagged as %s", tag.commitHash, tag.tagName);
  },
  error(err) {
    console.error("The Stream gave me an error: ", err);
  },
  complete() {
    console.log("The Stream told me it is done.");
  }
});

Our example would produce;

commit 11eb97230097883288ae565dda7d78b467d8d991 is tagged as 0.1.0
commit 4b106112ac52c81196e53a4b81cc3543b4aa42c6 is tagged as 0.2.0
commit 5f6ee8821fbebd01d0910125698afb495c36509c is tagged as 0.3.0
The Stream told me it is done.

Arguments

directory:String

Absolute path to your locally cloned git repository.

🙋🏿‍♀️ Getting Help

Get help with issues by creating a Bug Report or discuss ideas by opening a Feature Request.

👀 Other Projects

If you find my Open Source projects useful, please share them ❤️

• eslint-formatter-git-log
  ESLint Formatter featuring Git Author, Date, and Hash
• eslint-plugin-move-files
  Move and rename files while keeping imports up to date
• eslint-plugin-prefer-arrow-functions
  Convert functions to arrow functions
• ImageOptim-CLI
  Automates ImageOptim, ImageAlpha, and JPEGmini for Mac to make batch optimisation of images part of your automated build process.
• Jasmine-Matchers
  Write Beautiful Specs with Custom Matchers
• karma-benchmark
  Run Benchmark.js over multiple Browsers, with CI compatible output
• self-help
  Interactive Q&A Guides for Web and the Command Line
• syncpack
  Manage multiple package.json files, such as in Lerna Monorepos and Yarn Workspaces

🤓 Author

I'm Jamie Mason from Leeds in England, I began Web Design and Development in 1999 and have been Contracting and offering Consultancy as Fold Left Ltd since 2012. Who I've worked with includes Sky Sports, Sky Bet, Sky Poker, The Premier League, William Hill, Shell, Betfair, and Football Clubs including Leeds United, Spurs, West Ham, Arsenal, and more.

      

logservable's Issues

Read git log from oldest to newest

See if git log can take a parameter which gives you your git history in order of oldest to newest, instead of the default behaviour of newest to oldest.