❤
npm
Sign UpSign In

detect-readme-badges

1.4.0 • Public • Published

detect-readme-badges

Scans a repository readme file, searching for badges.

NPM version Build Status Coverage Status Dependency status Dev Dependency status Greenkeeper badge

Usage

detectReadmeBadges(readme) -> Array

Given a readme file (in string), detectReadmeBadges returns the array of badges found. Example:

const detectReadmeBadges = require('detect-readme-badges');
const badges = detectReadmeBadges(`
    ...
 
    > Simplified HTTP/HTTPS requests
 
    [![Build Status](https://travis-ci.org/sindresorhus/got.svg?branch=master)](https://travis-ci.org/sindresorhus/got) [![Coverage Status](https://coveralls.io/repos/sindresorhus/got/badge.svg?service=github&branch=master)](https://coveralls.io/github/sindresorhus/got?branch=master) [![Downloads](https://img.shields.io/npm/dm/got.svg)](https://npmjs.com/got)
 
    A nicer interface to the built-in ['http'](http://nodejs.org/api/http.html) module.
 
    ...
`)
 
// badges
[
    {
        urls: {
            original: 'https://travis-ci.org/sindresorhus/got.svg?branch=master',
            service: 'https://api.travis-ci.org/sindresorhus/got.svg?branch=master',
            shields: 'https://img.shields.io/travis/sindresorhus/got/master.svg',
            content: 'https://img.shields.io/travis/sindresorhus/got/master.json',
        },
        info: { service: 'travis', type: 'build', modifiers: { branch: 'master' } },
    },
    {
        urls: {
            original: 'https://coveralls.io/repos/sindresorhus/got/badge.svg?branch=master',
            service: 'https://coveralls.io/repos/sindresorhus/got/badge.svg?branch=master',
            shields: 'https://img.shields.io/coveralls/sindresorhus/got/master.svg',
            content: 'https://img.shields.io/coveralls/sindresorhus/got/master.json',
        },
        info: { service: 'coveralls', type: 'coverage', modifiers: { branch: 'master' } },
    },
    {
        urls: {
            original: 'https://img.shields.io/npm/dm/got.svg',
            shields: 'https://img.shields.io/npm/dm/got.svg',
            content: 'https://img.shields.io/npm/dm/got.json' },
        info: { service: 'npm', type: 'downloads', modifiers: { type: 'dm' } },
    },
]

badge.urls

urls.original the original matched url.

urls.service the service url.

urls.shields the shields.io equivalent url.

urls.content the shields.io url to extract a json of the badge's "value".

badge.info

Information extracted from the badge url.

info.type type of the badge. Available types are build, coverage, downloads, version, dependencies and misc.

info.service is the service that provides the badge. Available services are coveralls, david, npm (shields.io or nodei.co), travis and gitter.

info.modifiers are the badge modifiers that alter the interpretation of the repo/package depending on the service.

Tests

$ npm test $ npm test-cov to get coverage report

License

Released under the MIT License.

Readme

Keywords

Package Sidebar

Install

npm i detect-readme-badges

Repository

github.com/IndigoUnited/node-detect-readme-badges

Homepage

github.com/IndigoUnited/node-detect-readme-badges#readme

Weekly Downloads

8

Version

1.4.0

License

MIT

Unpacked Size

24 kB

Total Files

15

Last publish

Collaborators

  • carsy
  • satazor
Try on RunKit
Report malware