SCNT - Source Count
NodeJS utility program for counting source code lines (aka. SLOC).
Running this program in a folder, will parse each file in the directory (or directories depending on usage) and attempt to count the number of lines, characters, white-space, and comments (both block and inline if the language supports it).
After parsing and counting is complete, it outputs a tabular report of the findings.
Installation
The preferred usage is to install it as a program, ideally globally.
npm install -g scnt
npm i -g scnt
yarn global add scntIf you want to use it as a Node module, or in API mode, then install it locally.
npm install --save scnt
npm i -s scnt
yarn add scntUsage
scnt [options] [<file>|<directory>|<glob>...]
Running scnt with no options will execute with the default configuration. By default,
this will parse the contents of the current working directory with the standard parsers.
Additional help is available using the -h or --help argument.
Available Options
| Argument | Description |
|---|---|
-v, --version |
output the version number |
-D, --debug |
extra output info when processing (default: false) |
-i, --ignore-errors |
logs IO errors but continues processing (default: false) |
-e, --exclude <regex> |
excludes the files that match the regular expression, stackable with multiple usages (default: []) |
-a, --alias <extension>=<extension> |
alias one extension for another, stackable with multiple usages (default: {}) |
-p, --parsers <parsers...> |
list of Parser IDs to use, defaults to all |
-d, --default <parser> |
sets the default parser to use for unknowns by Parser ID (default is none, they are skipped) |
-l, --list-parsers |
lists the available parser id keys, only this will be performed if provided |
--dry-run |
does not read any files, just outputs all the debug information up to that point |
-h, --help |
display help for command |
Available Parsers
Plain Text
ID: plain
Name: "Plain Text"
Supported extensions: .txt, .md
C-Family
ID: cfamily
Name: "C-Family"
Supported extensions: .c, .cpp, .cc, .cxx, .cs, .h, .hpp, .hx, .js, .mjs, .jsx, .ts, .tsx, .java, .kt, .kts, .ktm, .php, .php5, .m, .mm, .swift, .scala, .sc, .sass, .scss, .less, .go, .rs
Example output
This output is taken directly from running scnt in the root folder of this repository, with no options.
Searching paths for ./*...
Processing file C:/scnt/clean.js
Processing file C:/scnt/LICENSE
Processing file C:/scnt/package-lock.json
Processing file C:/scnt/package.json
Processing file C:/scnt/README.md
Processing file C:/scnt/tsconfig.json
Completed processing 2 files
┌────────────────────────────┬────┐
│ Total of All Lines │ 83 │
├────────────────────────────┼────┤
│ Total Source Lines │ 52 │
├────────────────────────────┼────┤
│ Source Only Lines │ 51 │
├────────────────────────────┼────┤
│ Total Comment Lines │ 5 │
├────────────────────────────┼────┤
│ Inline Comment Lines │ 0 │
├────────────────────────────┼────┤
│ Block Comment Lines │ 4 │
├────────────────────────────┼────┤
│ Mixes Source/Comment Lines │ 1 │
├────────────────────────────┼────┤
│ Whitespace Only Lines │ 0 │
├────────────────────────────┼────┤
│ Empty Lines │ 27 │
└────────────────────────────┴────┘
┌─────────────────────────┬──────┐
│ Total Characters │ 3032 │
├─────────────────────────┼──────┤
│ Source Characters │ 1959 │
├─────────────────────────┼──────┤
│ Comment Characters │ 96 │
├─────────────────────────┼──────┤
│ Whitespace Characters │ 994 │
├─────────────────────────┼──────┤
│ Numerical Characters │ 1 │
├─────────────────────────┼──────┤
│ Alphabetical Characters │ 1555 │
├─────────────────────────┼──────┤
│ Special Characters │ 482 │
└─────────────────────────┴──────┘
License
MIT License.
See file LICENSE for full details. Licensed under the MIT license.