typecov

TypeCov

Track missing type coverage in TypeScript projects to ensure type safety

Features

👉 track type coverage defined as the count of symbols whose type is not any / the total count of symbols

👉 display type coverage directly in GitHub

👉 set minimal type coverage and automatically fail PRs

👉 supports monorepos

Motivation

Despite using --strict mode in tsconfig you can still have anys in your codebase. This tool gives you a good overview if PR that you are going to merge increases or decreases overall type coverage and where exactly types should be improved.

Install

``sh
npm install --save-dev typecov
`

Usage

TypeCov is built on CodeChecks.io - open source code review automation platform.

Are you new to codechecks? Check out getting started guide (it's simple)!

Install package and then add to your codechecks.yml file:

`yml
checks:
- name: typecov
options:
# atLeast: 99
# name: webapp
# tsconfigPath: ./tsconfig.prod.json
`

Under the hood it uses type-coverage package.

API

$3

#### options

`typescript
interface Options {
name?: string; // will be added to check name
tsconfigPath?: string; //defaults to tsconfig.json
atLeast?: number;
ignoreFiles?: string[];
ignoreCatch?: boolean;
strict?: boolean;
}
`

##### name

optional string

Defaults: Type Coverage

Specify the name for check. Might be useful in monorepos.

##### tsconfigPath

optional string

Default: tsconfig.json

Path to typescript project configuration

##### atLeast

optional number

Defaults: undefined

Example: atLeast: 99

Fail if coverage rate < this value.

##### ignoreFiles

optional string[]

Defaults: undefined

Specify the ignored for checks files.
See type-coverage's description for the reference.

##### ignoreCatch

optional string

Defaults: undefined

See type-coverage's description for the reference.

##### strict

optional string

Defaults: undefined`

See type-coverage's description for the reference.

Contributing

All contributions are welcomed. Read more in CONTRIBUTING.md

Licence

MIT @ codechecks.io