aboutsummaryrefslogtreecommitdiff
path: root/node_modules/code-excerpt/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/code-excerpt/readme.md')
-rw-r--r--node_modules/code-excerpt/readme.md73
1 files changed, 73 insertions, 0 deletions
diff --git a/node_modules/code-excerpt/readme.md b/node_modules/code-excerpt/readme.md
new file mode 100644
index 000000000..216b6b3d5
--- /dev/null
+++ b/node_modules/code-excerpt/readme.md
@@ -0,0 +1,73 @@
+# code-excerpt [![Build Status](https://travis-ci.org/vadimdemedes/code-excerpt.svg?branch=master)](https://travis-ci.org/vadimdemedes/code-excerpt)
+
+> Extract code excerpts
+
+
+## Install
+
+```
+$ npm install --save code-excerpt
+```
+
+
+## Usage
+
+```js
+const codeExcerpt = require('code-excerpt');
+
+const source = `
+'use strict';
+
+function someFunc() {}
+
+module.exports = () => {
+ const a = 1;
+ const b = 2;
+ const c = 3;
+
+ someFunc();
+};
+`.trim();
+
+const excerpt = codeExcerpt(source, 5);
+//=> [
+// {line: 2, value: ''},
+// {line: 3, value: 'function someFunc() {}'},
+// {line: 4, value: ''},
+// {line: 5, value: 'module.exports = () => {'},
+// {line: 6, value: ' const a = 1;'},
+// {line: 7, value: ' const b = 2;'},
+// {line: 8, value: ' const c = 3;'}
+// ]
+```
+
+
+## API
+
+### codeExcerpt(source, line, [options])
+
+#### source
+
+Type: `string`
+
+Source code.
+
+#### line
+
+Type: `number`
+
+Line number to extract excerpt for.
+
+#### options
+
+##### around
+
+Type: `number`<br>
+Default: `3`
+
+Number of surrounding lines to extract.
+
+
+## License
+
+MIT © [Vadim Demedes](https://github.com/vadimdemedes)