Skip to content

Latest commit

 

History

History
97 lines (72 loc) · 1.9 KB

README.md

File metadata and controls

97 lines (72 loc) · 1.9 KB

ts-reporter 🚲

Migrating your huge app from Javascript to Typescript? This project provides a burndown chart (as a .png, along with raw .json) of your remaining LOC to convert!

  • See the progress that you're making instead of feeling like you're getting nowhere. 💪
  • Easily integrate as an artifact of your CI
  • 🌌 Dark mode! --dark

Example burndown chart from a large project

Install in project

yarn add ts-reporter --dev
# or
npm i ts-reporter --save-dev

package.json:

{
  "scripts": {
    "build-ts-reporter": "ts-reporter build src/"
  }
}
  1. Run
npm run build-ts-reporter
# or
yarn build-ts-reporter

# or directly, without adding to package.json:
npx ts-reporter build src/

Install globally

yarn global add ts-reporter
# or
npm i --global ts-reporter
ts-reporter build src/

Run as part of build

Azure Devops

Install ts-reporter:

yarn add --dev ts-reporter
#or
npm i --save-dev ts-reporter

Add to azure-pipelines.yml:

# [...]
- job: ts_reporter
  container: node:15
  steps:
    - checkout: self
      fetchDepth: 1000
    - script: |
        npm ci
      displayName: Install
    - script: |
        git checkout -- .
        npx ts-reporter build src
      displayName: Run ts-reporter
    - task: PublishPipelineArtifact@1
    inputs:
        targetPath: $(System.DefaultWorkingDirectory)/reports
        artifactName: reports
# [...]

Something else?

PRs welcome for documentation!

FAQ

Why is my CI failing to npm install?

If your build agent is using node v16, you might need to use node v15. node-canvas doesn't support prebuilts of node v16 as of the time of this writing.

npm ERR! node-pre-gyp WARN Pre-built binaries not found for [email protected] and [email protected] (node-v93 ABI, glibc) (falling back to source compile with node-gyp)