doctrine-file

2.0.1 • Public • Published

Doctrine-File

File-Reader for the Doctrine JSDoc Parser

Build Status codecov

Installation

You can install Doctrine-File using npm:

$ npm install doctrine-file --save-dev

Usage

Import doctrine-File inside of your JavaScript:

import { parseFile, parseFileContent } from 'doctrine-file';

parseFile(file[, options], callback)

  • file String PathName to a textfile
  • options Object
    • All options that doctrine.parse supports, except unwrap which can't be changed.
  • callback Function

The callback is passed two arguments (err, comments), where comments is an array of doctrine results. If no JSDocs can be extracted from the file, the array will be empty. When the file cannot be read err will contain the Error.

Here's a simple example:

parseFile('somefile.js', (err, comments) => {
  if (err) throw err;
 
  comments.forEach(console.log);
});

parseFileContent(content[, options])

  • content String | Buffer Content of a complete file to be parsed
  • options Object
    • All options that doctrine.parse supports, except unwrap which can't be changed.

Here's a simple example:

const content = fs.readFileSync('somefile.js', 'utf-8');
 
const comments = parseFileContent(content);
 
comments.forEach(console.log);

License

doctrine-file is licensed under the MIT license.

Dependencies (1)

Dev Dependencies (22)

Package Sidebar

Install

npm i doctrine-file

Weekly Downloads

5,724

Version

2.0.1

License

MIT

Unpacked Size

10.3 kB

Total Files

8

Last publish

Collaborators

  • grid_rg
  • haeusler
  • researchgate-bot
  • mdio
  • bashofmann
  • danez