indefinite

What is indefinite?

The 'indefinite' npm package is used to determine the correct indefinite article ('a' or 'an') for a given word or phrase. This can be particularly useful in natural language processing, text generation, and other applications where proper grammar is important.

What are indefinite's main functionalities?

Basic Usage

This feature allows you to get the correct indefinite article for a single word. The function takes a word as input and returns the word prefixed with the correct indefinite article.

const indefinite = require('indefinite');
console.log(indefinite('apple')); // Output: 'an apple'
console.log(indefinite('banana')); // Output: 'a banana'

Handling Phrases

This feature allows you to get the correct indefinite article for a phrase. The function takes a phrase as input and returns the phrase prefixed with the correct indefinite article.

const indefinite = require('indefinite');
console.log(indefinite('hour of work')); // Output: 'an hour of work'
console.log(indefinite('unicorn in the garden')); // Output: 'a unicorn in the garden'

Custom Options

This feature allows you to customize the output, such as capitalizing the first letter of the article. The function takes a word or phrase and an options object as input and returns the word or phrase prefixed with the correct indefinite article, formatted according to the options.

const indefinite = require('indefinite');
console.log(indefinite('apple', { capitalize: true })); // Output: 'An apple'
console.log(indefinite('banana', { capitalize: true })); // Output: 'A banana'

Other packages similar to indefinite

an

The 'an' package provides similar functionality by determining whether to use 'a' or 'an' before a word. It is simpler and more lightweight compared to 'indefinite', but it may not handle complex phrases as effectively.

article

The 'article' package also determines the correct indefinite article for a given word. It is comparable to 'indefinite' in terms of functionality but may have different handling for edge cases and custom options.

README

indefinite

Prefix a noun with an indefinite article - a or an - based on whether it begins with a vowel.

Installation

npm install --save indefinite

Summary

It's not hard to check whether a noun begins with a vowel and decide whether to prefix with "a" or "an," but I got tired of doing it manually every time. So now there's this. Just pass in the word, and indefinite will return the word prefixed with either "a " or "an " depending on the first letter of the word.

Usage

var a = require('indefinite');

console.log(a('apple')); // "an apple"
console.log(a('banana')); // "a banana"

// You can also capitalize the article by passing "true" as the second argument
console.log(a('apple', true)); // 'An apple'
console.log(a('banana', true)); // 'A banana'

Browser

Just serve dist/indefinite.min.js however you serve javascript, then call indefinite("noun"). The indefinite function is added to window.

Contributing

Please see the contribution guidelines.