word-counter-om

A simple yet powerful NPM CLI tool to count word occurrences in a given file.
It also allows you to search for the frequency of a specific word.

📦 Installation

You can install the package either locally (via npx) or globally.

Global Installation:

npm install -g word-counter-om

Run Without Installation (Using npx):

npx countin <filename> [singleWord]

countin is the CLI command (alias) defined in the package.

🚀 Usage

countin <filename> [singleWord]

• <filename>: Required. Path to the text file you want to analyze.
• [singleWord]: Optional. A specific word to search for in the file.

Example 1 – Count all words:

countin sample.txt

Output (example):

{
  hello: 3,
  world: 2,
  javascript: 5,
  ...
}

Example 2 – Count a single word:

countin sample.txt javascript

Output:

The word "javascript" appeared 5 times.

📝 Word Splitting Rules

This CLI tool intelligently splits words by recognizing special characters and punctuation marks.
Some key rules:

• Words like Jay's will be split into: jay and s.
• Compound terms like express.js will be split into: express and js.
• Hyphenated words like time-pass will be split into: time and pass.

This ensures a more accurate word frequency analysis.

📂 Use Cases

• Word frequency analysis for text files
• Keyword density checker
• Text analytics for blogs, articles, or transcripts

🔧 Author

Created by Om Vaghela
📸 Instagram: @om_2804_

Try it out and feel free to share feedback or suggestions!