string-mutilator

A JavaScript library for mutilate strings.

Motivation background

Most of the code from this project was created during a personal codegolf competition to distort the appearance of strings as much as possible but without actually destroying their contents.

So the name mutilator come into my mind.

mutilator (plural mutilators)

Agent noun of mutilate; one who mutilates.

This sounds unnecessarily brutal for now, but I assure you that no strings will be harmed permanently, as long as the functions are used correctly. 😏

So I decided to combine these "strange" functions into one library. More or less just for fun.

Demo

A comprehensive demo of all functions can be found in the demonstration of this library/package in the demo project pseudeo-chiperer.

Modules

stringMutilator/charCase: Functions for manipulating the letter case of strings.
stringMutilator/compressor: Functions for compressing (pack/unpack etc.) strings.
stringMutilator: Functions for mutilating strings.
stringMutilator/unicode: Functions for handle unicode stuff.

Functions

flipBits(string) ⇒ string

Flip the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we flip the bits (so every 0 becomes 1 and vice versa) they look like this 11111111 10111110. This means that 'A' (U+0041) becomes 'ﾾ' (U+FFBE).

gobbledygook(string, [exclude]) ⇒ string

Applies toMANS to all characters with a random type. For example 'Hello World' turns into '𝐇𝖾𝓵𝗹𝘰 𝔚𝗈𝒓𝔩𝔡'.

jumble(string, [runs]) ⇒ string

Jumble the letters of all words in a string, except the first and last one, to keep it readable.

reverseBits(string) ⇒ string

Reverse the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we reverse the bits they look like this 10000010 00000000. This means that 'A' (U+0041) becomes '舀' (U+8200).

reverse(string) ⇒ string

Reverse a string.

rockdotize(string, [regexp]) ⇒ string

Create a heavy metal like rockdot string.

rot13(string) ⇒ string

Rotate the character indexes of a string by 13 digits.

scramble(string) ⇒ string

Randomize the order of the characters in a string.

shiftBits(string, [n]) ⇒ string

Rotate the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we shift the bits by -4 n digits they look like this 00010000 00000100. This means that 'A' (U+0041) becomes 'င' (U+1004).

shift(string, [n]) ⇒ string

Shift the characters of a string by n digits.

toMANS(string, [type]) ⇒ string

Convert A-Z to Mathematical Alphanumeric Symbols.

List of type values:

`type`	Unicode name
0	Mathematical Bold *
1	Mathematical Italic *
2	Mathematical Bold Italic *
3	Mathematical Script Capital *
4	Mathematical Bold Script *
5	Mathematical Fraktur *
6	Mathematical Double-Struck *
7	Mathematical Bold Fraktur *
8	Mathematical Sans-Serif *
9	Mathematical Sans-Serif Bold *
10	Mathematical Sans-Serif Italic *
11	Mathematical Sans-Serif Bold Italic *
12	Mathematical Monospace *

stringMutilator/charCase

Functions for manipulating the letter case of strings.

stringMutilator/charCase
- ~invert(string, [every]) ⇒ string
- ~snakeCase(string) ⇒ string
- ~camelCase(string) ⇒ string
- ~kebabCase(string) ⇒ string
- ~dotCase(string) ⇒ string
- ~pascalCase(string) ⇒ string
- ~capitalize(string) ⇒ string

stringMutilator/charCase~invert(string, [every]) ⇒ `string`

Invert the case of letters in a string.

Kind: inner method of stringMutilator/charCase

Param	Type	Default	Description
string	`string`		The string to be case inverted.
[every]	`number`	`0`	Only invert every `n` letter.

Example

stringMutilator.charCase.invert('Hello World!');
// > 'hELLO wORLD!'

stringMutilator/charCase~snakeCase(string) ⇒ `string`

Change the case of given string to "Snake Case".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.snakeCase('Hello World');
// > 'hello_world'

stringMutilator/charCase~camelCase(string) ⇒ `string`

Change the case of the given string to "Camel Case".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.camelCase('Hello World');
// > 'helloWorld'

stringMutilator/charCase~kebabCase(string) ⇒ `string`

Change the case of the given string to "Kebap Case".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.kebabCase('Hello World');
// > 'hello-world'

stringMutilator/charCase~dotCase(string) ⇒ `string`

Change the case of the given string to "Dot Case".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.dotCase('Hello World');
// > 'hello.world'

stringMutilator/charCase~pascalCase(string) ⇒ `string`

Change the case of the given string to "Pascal Case".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.pascalCase('Hello World');
// > 'HelloWorld'

stringMutilator/charCase~capitalize(string) ⇒ `string`

Change the case of the given string to "Capitalized".

Kind: inner method of stringMutilator/charCase

Param	Type
string	`string`

Example

stringMutilator.charCase.capitalize('hello world');
// > 'Hello World'

stringMutilator/compressor

Functions for compressing (pack/unpack etc.) strings.

stringMutilator/compressor
- ~pack(string) ⇒ string
- ~unpack(string) ⇒ string
- ~signature(string, [withEval]) ⇒ string

stringMutilator/compressor~pack(string) ⇒ `string`

Pack all characters of a 8-bit string.

Kind: inner method of stringMutilator/compressor

Param	Type	Description
string	`string`	A 8-bit string to pack.

Example

stringMutilator.compressor.pack('Hello World!');
// > '䡥汬漠坯牬搡'

stringMutilator/compressor~unpack(string) ⇒ `string`

Unpack a packed string.

Kind: inner method of stringMutilator/compressor

Param	Type	Description
string	`string`	The packed string to unpack.

Example

stringMutilator.compressor.unpack('䡥汬漠坯牬搡');
// > 'Hello World!'

stringMutilator/compressor~signature(string, [withEval]) ⇒ `string`

Return the given, packed string with the unpack signature.

Kind: inner method of stringMutilator/compressor

Param	Type	Default	Description
string	`string`		The packed string to signature.
[withEval]	`boolean`	`false`	Determine if the result includes a `eval` command for executing code.

Example

stringMutilator.compressor.signature('䡥汬漠坯牬搡');
// > 'unescape(escape("䡥汬漠坯牬搡").replace(/u(..)/g, "$1%");'

stringMutilator

Functions for mutilating strings.

stringMutilator/unicode

Functions for handle unicode stuff.

stringMutilator/unicode
- ~fixSurrogates(string) ⇒ string
- ~unfixSurrogates(string) ⇒ string

stringMutilator/unicode~fixSurrogates(string) ⇒ `string`

Fix unpaired high/low surrogates by adding a blank high/low surrogate (U+D800 or U+DC00) to the designated location. An unpaired surrogate can lead to problems, for example by copying it to the clipboard could result in a Replacement Character � (U+FFFD). For example if the string is '\uD801' it will be altered to '\uD801\uDC00' ('𐐀') or '\uDE80' to '\uD800\uDE80' ('𐊀').

Kind: inner method of stringMutilator/unicode
See: https://en.wikipedia.org/wiki/UTF-16#U+D800_to_U+DFFF

Param	Type	Description
string	`string`	The input string

Example

stringMutilator.unicode.fixSurrogates('Test: \uD801 \uDE80');
// > 'Test: 𐐀 𐊀'

stringMutilator/unicode~unfixSurrogates(string) ⇒ `string`

Remove the by fixSurrogates added blank high/low surrogates.

Kind: inner method of stringMutilator/unicode

Param	Type	Description
string	`string`	The input string

Example

stringMutilator.unfixSurrogates('Test: 𐐀 𐊀');
// > 'Test: \uD801 \uDE80'

flipBits(string) ⇒ `string`

Flip the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we flip the bits (so every 0 becomes 1 and vice versa) they look like this 11111111 10111110. This means that 'A' (U+0041) becomes 'ﾾ' (U+FFBE).

Kind: global function

Param	Type	Description
string	`string`	The input string.

Example

stringMutilator.flipBits('Hello World!');
// > 'ﾷﾚﾓﾓﾐ￟ﾨﾐﾍﾓﾛ￞'

gobbledygook(string, [exclude]) ⇒ `string`

Applies toMANS to all characters with a random type. For example 'Hello World' turns into '𝐇𝖾𝓵𝗹𝘰 𝔚𝗈𝒓𝔩𝔡'.

Kind: global function

Param	Type	Default	Description
string	`string`		The input string
[exclude]	`array`	`[ 1, 2 ]`	Exclude specific `type` of `toMANS`

Example

stringMutilator.gobbledygook('Hello World');
// > 𝐇𝖾𝓵𝗹𝘰 𝔚𝗈𝒓𝔩𝔡

jumble(string, [runs]) ⇒ `string`

Jumble the letters of all words in a string, except the first and last one, to keep it readable.

Kind: global function
See: https://www.mnn.com/lifestyle/arts-culture/stories/why-your-brain-can-read-jumbled-letters

Param	Type	Default	Description
string	`string`		The input string.
[runs]	`number`	`3`	The number of attempts to get a real randomized word string.

Example

stringMutilator.jumble('Hello World!');
// > 'Hlelo Wrlod!'

reverseBits(string) ⇒ `string`

Reverse the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we reverse the bits they look like this 10000010 00000000. This means that 'A' (U+0041) becomes '舀' (U+8200).

Kind: global function

Param	Type	Description
string	`string`	The input string.

Example

stringMutilator.reverseBits('Hello World!');
// > 'ሀꘀ㘀㘀Ѐ一㘀☀萀'

reverse(string) ⇒ `string`

Reverse a string.

Kind: global function

Param	Type	Description
string	`string`	The input string.

Example

stringMutilator.reverse('Hello World!');
// > '!dlroW olleH'

rockdotize(string, [regexp]) ⇒ `string`

Create a heavy metal like rockdot string.

Kind: global function
See

Param	Type	Default	Description
string	`string`		The string to rockdotize.
[regexp]	`RegExp`	`<RegExp /\w/gi>`	A RegExp to select every character that should get rockdotized.

Example

stringMutilator.rockdotize('Hello World!');
// > 'Ḧël̈l̈ö Ẅör̈l̈d̈!'

rot13(string) ⇒ `string`

Rotate the character indexes of a string by 13 digits.

Kind: global function
See: https://en.wikipedia.org/wiki/ROT13

Param	Type	Description
string	`string`	The input string.

Example

stringMutilator.rot13('Hello World!');
// > 'Uryyb Jbeyq!'

scramble(string) ⇒ `string`

Randomize the order of the characters in a string.

Kind: global function

Param	Type	Description
string	`string`	The string to scramble.

Example

stringMutilator.scramble('Hello World!');
// > 'WorH!llo led'

shiftBits(string, [n]) ⇒ `string`

Rotate the character bits of a string. The 16 character bits of 'A' are 00000000 01000001 - if we shift the bits by -4 n digits they look like this 00010000 00000100. This means that 'A' (U+0041) becomes 'င' (U+1004).

Kind: global function

Param	Type	Default	Description
string	`string`		The input string.
[n]	`number`	`1`	Number of digits to rotate the character bit. Positive for right rotation, negative for left rotation.

shift(string, [n]) ⇒ `string`

Shift the characters of a string by n digits.

Kind: global function

Param	Type	Default	Description
string	`string`		The string to shift.
[n]	`number`	`1`	Number of digits to rotate the characters. Positive for right rotation, negative for left rotation.

Example

stringMutilator.shift('Hello World!', 3);
// > 'lo World!Hel'

toMANS(string, [type]) ⇒ `string`

Convert A-Z to Mathematical Alphanumeric Symbols.

List of type values:

`type`	Unicode name
0	Mathematical Bold *
1	Mathematical Italic *
2	Mathematical Bold Italic *
3	Mathematical Script Capital *
4	Mathematical Bold Script *
5	Mathematical Fraktur *
6	Mathematical Double-Struck *
7	Mathematical Bold Fraktur *
8	Mathematical Sans-Serif *
9	Mathematical Sans-Serif Bold *
10	Mathematical Sans-Serif Italic *
11	Mathematical Sans-Serif Bold Italic *
12	Mathematical Monospace *

Kind: global function
See: https://unicode-table.com/en/blocks/mathematical-alphanumeric-symbols

Param	Type	Default	Description
string	`string`		The input string.
[type]	`number`	`0`	A number between 0 and 12.

Example

stringMutilator.toMANS('Hello World!', 1);
// > '𝐻𝑒𝑙𝑙𝑜 𝑊𝑜𝑟𝑙𝑑.'

Involutory functions

An involutory function, is a function f that is its own inverse.

List of involutory functions

flipBits
reverse
reverseBits
rot13

Example

import { rot13 } from '@0x04/string-mutilator';

rot13(rot13('Hello World!')) === 'Hello World!';
// > true

List of involutory functions with negated arguments

charCase.invert
shift
shiftBits

Example

import { shift } from '@0x04/string-mutilator';

shift(shift('Hello World!', 5), -5) === 'Hello World!';
// > true

List of involutory functions with counter function

compressor.pack / compressor.unpack
unicode.fixSurrogates / unicode.unfixSurrogates

Examples

import { compressor } from '@0x04/string-mutilator';

compressor.unpack(compressor.pack('Hello World!')) === 'Hello World!';
// > true

List of non involutory functions

compressor.signature
gobbledygook
jumble
rockdotize
scramble
toMANS

import { jumble } from '@0x04/string-mutilator';

jumble(jumble('Hello World!')) === 'Hello World!';
// > false

Using the CLI

Install

To use it in your project

$ npm install --save @0x04/string-mutilator

To use it globally

$ npm install --global @0x04/string-mutilator

General usage

$ string-mutilator --help

  Functions for mutilating strings.

  Usage
  $ string-mutilator <function> <string> [argument]...

    Functions
      charCase.invert
      compressor.pack
      compressor.unpack
      compressor.signature
      charCase.snakeCase
      charCase.camelCase
      charCase.kebabCase
      charCase.dotCase
      charCase.pascalCase
      charCase.capitalize
      flipBits
      gobbledygook
      jumble
      reverse
      reverseBits
      rockdotize
      rot13
      scramble
      shift
      shiftBits
      toMANS
      unicode.fixSurrogates
      unicode.unfixSurrogates

    Examples
      $ string-mutilator shift "Hello World!" 6
      $ string-mutilator charCase.invert "Hello World!"
      $ string-mutilator toMANS "Hello World!" 4

Name		Name	Last commit message	Last commit date
Latest commit History 40 Commits
.github/workflows		.github/workflows
src		src
test		test
.babelrc		.babelrc
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmignore		.npmignore
.versionrc		.versionrc
changelog.md		changelog.md
cli.js		cli.js
index.js		index.js
license		license
package-lock.json		package-lock.json
package.json		package.json
readme.md		readme.md
template-readme.hbs		template-readme.hbs

License

0x04/string-mutilator

Folders and files

Latest commit

History

Repository files navigation

string-mutilator

Motivation background

Demo

Table of content

Modules

Functions

stringMutilator/charCase

stringMutilator/charCase~invert(string, [every]) ⇒ string

stringMutilator/charCase~snakeCase(string) ⇒ string

stringMutilator/charCase~camelCase(string) ⇒ string

stringMutilator/charCase~kebabCase(string) ⇒ string

stringMutilator/charCase~dotCase(string) ⇒ string

stringMutilator/charCase~pascalCase(string) ⇒ string

stringMutilator/charCase~capitalize(string) ⇒ string

stringMutilator/compressor

stringMutilator/compressor~pack(string) ⇒ string

stringMutilator/compressor~unpack(string) ⇒ string

stringMutilator/compressor~signature(string, [withEval]) ⇒ string

stringMutilator

stringMutilator/unicode

stringMutilator/unicode~fixSurrogates(string) ⇒ string

stringMutilator/unicode~unfixSurrogates(string) ⇒ string

flipBits(string) ⇒ string

gobbledygook(string, [exclude]) ⇒ string

jumble(string, [runs]) ⇒ string

reverseBits(string) ⇒ string

reverse(string) ⇒ string

rockdotize(string, [regexp]) ⇒ string

rot13(string) ⇒ string

scramble(string) ⇒ string

shiftBits(string, [n]) ⇒ string

shift(string, [n]) ⇒ string

toMANS(string, [type]) ⇒ string

Involutory functions

List of involutory functions

List of involutory functions with negated arguments

List of involutory functions with counter function

List of non involutory functions

Using the CLI

Install

General usage

License

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 3

Packages 0

Languages

stringMutilator/charCase~invert(string, [every]) ⇒ `string`

stringMutilator/charCase~snakeCase(string) ⇒ `string`

stringMutilator/charCase~camelCase(string) ⇒ `string`

stringMutilator/charCase~kebabCase(string) ⇒ `string`

stringMutilator/charCase~dotCase(string) ⇒ `string`

stringMutilator/charCase~pascalCase(string) ⇒ `string`

stringMutilator/charCase~capitalize(string) ⇒ `string`

stringMutilator/compressor~pack(string) ⇒ `string`

stringMutilator/compressor~unpack(string) ⇒ `string`

stringMutilator/compressor~signature(string, [withEval]) ⇒ `string`

stringMutilator/unicode~fixSurrogates(string) ⇒ `string`

stringMutilator/unicode~unfixSurrogates(string) ⇒ `string`

flipBits(string) ⇒ `string`

gobbledygook(string, [exclude]) ⇒ `string`

jumble(string, [runs]) ⇒ `string`

reverseBits(string) ⇒ `string`

reverse(string) ⇒ `string`

rockdotize(string, [regexp]) ⇒ `string`

rot13(string) ⇒ `string`

scramble(string) ⇒ `string`

shiftBits(string, [n]) ⇒ `string`

shift(string, [n]) ⇒ `string`

toMANS(string, [type]) ⇒ `string`

Packages