Casing

Convert the casing of a string to common alternatives

Easily swap between common variable name casing formats with these utility functions. Many of the most common formats have an implementation and can be used as both an input or output. Import them into your projects or use them on the command line!

Install

Use your favourite package manager

Using npm:

$ npm install @dannywrayuk/casing

Using yarn:

$ yarn add @dannywrayuk/casing

Using pnpm:

$ pnpm add @dannywrayuk/casing

Usage

Import the casings directly into your project.

import { pascal } from "@dannywrayuk/casing";

const projectName = "PROJECT_NAME";

const projectNameInPascalCase = pascal(projectName);

console.log(projectNameInPascalCase);
// ProjectName

or use it on the command line

$ casing upperSnake string-to-convert
STRING_TO_CONVERT

Even without installation

$ npx @dannywrayuk/casing upperSnake string-to-convert

Options

The possible output styles are:

If none of these meet your needs, there is also a custom function that accepts a set of options to customise the output (not available on the command line).

import { custom } from "@dannywrayuk/casing";

const projectName = "PROJECT_NAME";

const projectNameInCustomCase = custom(projectName, {
  delimiter: ".",
});

console.log(projectNameInCustomCase);
// project.name

The allowed custom options are:

export type customOptions = {
  // Delimiter applied between each word of the output
  delimiter?: string;

  // A function that transforms a word, this is applied to each word
  wordOperation?: (input: string) => string;

  // Should the first word be skipped by wordOperation. Defaults is false.
  excludeFirstWord?: boolean;

  // It's unlikely you will need this. Enables the parsing of a custom delimiter on the input string.
  splitDelimiters?: string;
};

Contribution

If there is an option or feature you would like to see, please feel free to raise an issue or open a pull request. Contributions are welcome :)

License

MIT © Danny Wray