# underscore.inflections

> Port of ActiveSupport::Inflector::Inflections for underscore.js

Latest version **0.2.1** (published 2013-08-13) · 0 weekly downloads

## Install

```sh
npm install underscore.inflections
pnpm add underscore.inflections
yarn add underscore.inflections
bun add underscore.inflections
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 0.2.1 |
| Published | 2013-08-13 |
| First published | 2012-06-13 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 29 |
| Author | Robby Colvin |
| Maintainers | geetarista |
| Keywords | inflections, inflector, underscore |

## Links

- npm: https://www.npmjs.com/package/underscore.inflections
- Repository: http://github.com/geetarista/underscore.inflections
- Homepage: https://geetarista.github.com/underscore.inflections
- Issues: https://github.com/geetarista/underscore.inflections/issues
- npm.io page: https://npm.io/package/underscore.inflections

## Dependencies (2)

- [underscore](https://npm.io/package/underscore.md) >=1.0
- [underscore.string](https://npm.io/package/underscore.string.md) >=2.0.0

## Alternatives

- [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads
- [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads
- [react-native-ios-utilities](https://npm.io/package/react-native-ios-utilities.md) — 138.5K weekly downloads
- [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads
- [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads

## Recent versions

- 0.2.1 (latest) — 2013-08-13
- 0.2.0 — 2013-08-01
- 0.1.5 — 2013-04-10
- 0.1.4 — 2012-12-06
- 0.1.3 — 2012-06-14
- 0.1.2 — 2012-06-13
- 0.1.1 — 2012-06-13
- 0.1.0 — 2012-06-13

## README

# underscore.inflections [![Build Status](https://secure.travis-ci.org/geetarista/underscore.inflections.png)](http://travis-ci.org/geetarista/underscore.inflections)

Port of ActiveSupport::Inflector::Inflections for Underscore.js.

Works with browser or Node.js.

## Introduction

I created this underscore mixin after trying out every other inflection library out there. I've created this as a direct port of Rails' version as much as possible.

Note that right now, this only handles methods found in ActiveSupport::Inflector::Inflections since that's all I need right now. I may eventually split this out into separate inflector mixins that match all of ActiveSupport's.

## Setup

### Browser

Include both underscore.js and underscore.inflections on your page:

```html
<script src="underscore.js" type="text/javascript"></script>
<script src="underscore.inflections.js" type="text/javascript"></script>
```

### Node.js

First, install the mixin through npm:

```bash
npm install underscore.inflections
```

Require underscore.js and underscore.inflections:

```javascript
var _ = require('underscore');
_.mixin(require('underscore.inflections'));
```

**Note**: When using underscore in Node's REPL, be sure to choose a variable other than `_`, as that is a special symbol used for showing the last return value.

## Usage

### Singularize

Converts a word to its singular form.

Examples:

```javascript
_.singularize('posts');    //=> 'post'
_.singularize('octopi');   //=> 'octopus'
_.singularize('sheep');    //=> 'sheep'
_.singularize('words');    //=> 'words'
```

### Pluralize

Converts a word to its pluralized form.

Examples:

```javascript
_.pluralize('post');      //=> 'posts'
_.pluralize('octopus');   //=> 'octopi'
_.pluralize('sheep');     //=> 'sheep'
_.pluralize('words');     //=> 'words'
```

## Customizing

### Singular

Adds a rule for singularizing a word.

Example:

```javascript
_.singular(/^(ox)en/i, '\1');
```

### Plural

Adds a rule for pluralizing a word.

Example:

```javascript
_.plural(/^(ox)$/i, '\1en');
```

### Irregular

Adds a rule for an irregular word.

Example:

```javascript
_.irregular('person', 'people');
```

### Uncountable

Adds a rule for an uncountable word or words.

Example:

```javascript
_.uncountable(['fish', 'sheep']);
```

### Acronym

Makes the following inflection methods aware of acronyms: _.camelize, _.underscore, _.humanize, _.titleize
See inflections_test for a full specifications of the subtleties

```javascript
_.acronym("FBI");
_.camelize("fbi_file"); //=> 'FBIFile'
_.underscore("FBIFile"); //=> 'fbi_file'
```

### Camelize

Example:
```javascript
_.camelize('make_me_tall');  //=> 'MakeMeTall'
```

When passed false as second parameter it does not capitalize the first word

Example:
```javascript
_.camelize('make_me_tall', false);  //=> 'makeMeTall'
```

### Underscore

Separate camel cased strings with underscores

Example:
```javascript
_.underscore('INeedSomeSpace');  //=> 'i_need_some_space'
```

## Humanize

Format underscored strings for human friendly consumption

Example:
```javascript
_.humanize('i_just_want_to_be_understood');  //=> 'I just want to be understood'
```

You can also add humanizing rules by calling ```_.human```

Example:
```javascript
_.human(/_cnt$/,'_count');
_.humanize('jargon_cnt');  //=> 'Jargon count'
```

## titleize

Title case a underscored or camel cased string

Example:
```javascript
_.titleize('three_blind_mice');  //=> 'Three Blind Mice'
_.titleize('JackAndJill'); //=> 'Jack And Jill'
```

## License

MIT. See `LICENSE`.

---
_Source: https://npm.io/package/underscore.inflections · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._