Skip to content

Pre-evaluate git info, version number, timestamp, etc at build time

License

Notifications You must be signed in to change notification settings

justinlettau/preval-build-info

Repository files navigation

NPM Version CI codecov

Preval Build Info

Pre-evaluate git info, version number, timestamp, etc at build time.

Useful if you need build information in your application but you use a predefined build system (and don't want to eject) like Angular CLI, for example. Other common solutions require adding a file to your repository and committing it. That's not ideal because these values change so frequently (every commit). preval-build-info works by reading information from your repository, but storing the build information within the node_modules folder.

Table of Contents

Features

  • 🚀 Import Git information of your repo.
  • 🕑 Includes version number and build timestamp.
  • 📂 No need to include extra files in your repo.
  • 🎉 TypeScript types included.

Installation

npm install preval-build-info --save

Usage

When you import preval-build-info, it contains the information for your repository. The version is pulled from your project's package.json and all the Git information is from your repo.

import * as info from 'preval-build-info';

console.log(info.version);
// => '1.0.0'

console.log(info.timestamp);
// => '1614300015989'

console.log(info.dateTime);
// => '2021-02-26T00:40:15.989Z'

console.log(info.gitHash);
// => 'c8b316d820b7c9cb3b99e8739c2212d34c892815'

console.log(info.gitHashShort);
// => 'c8b316d'

console.log(info.gitTag);
// => 'v1.0.0'

console.log(info.gitBranch);
// => 'master'

Build information is generated on postinstall. If you also need to update build info manually, you can use preval-build-info-cli in your project's scripts. For example:

"scripts": {
  "prebuild": "preval-build-info-cli",
}

Development

npm install
npm run build

About

Pre-evaluate git info, version number, timestamp, etc at build time

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published