Meta toolkit is a toolkit to help with meta programming and OOP. It is a no-dependency, no-nonsense collection of small bits my projects accumulated over the years. They deal with helping to generate classes, objects, prototypes, iterators, and more.
- Name mangling (
meta-toolkit/names.js
) provides a conversion from compound names such asfoo-bar
to['foo', 'bar']
and from['foo', 'bar']
tofooBar
and vice versa.- Used to generated file names, method names, and so on.
- The following naming schemas are supported out of box:
camelCase
—toCamelCase()
,fromCamelCase()
.PascalCase
—toPascalCase()
,fromPascalCase()
.snake_case
—toSnakeCase()
,fromSnakeCase()
.SNAKE_CASE
—toAllCapsSnakeCase()
.
kebab-case
—toKebabCase()
,fromKebabCase()
.
- Descriptor manipulation (
meta-toolkit/descriptors.js
) provides a set of helpers used to generate various accessors dynamically and share them between different objects/prototypes:- Create descriptors —
makeGetter()
,makeSetter()
,makeAccessors()
. - Add descriptors —
addDescriptor()
,addDescriptors()
,addAccessor()
,addGetters()
. - Copy descriptors —
copyDescriptors()
.
- Create descriptors —
- Aliases (
meta-toolkit/aliases.js
) provides a set of helpers to alias existing properties:- Alias properties —
addAlias()
,addAliases()
.
- Alias properties —
- Prototypes (
meta-toolkit/prototypes.js
) provides a set of helpers to inspect prototypes:- Iterate over prototypes —
prototypes()
. getPropertyDescriptor()
— similar togetOwnPropertyDescriptor()
, but for all prototypes not just the current object.
- Iterate over prototypes —
- Iterators (
meta-toolkit/iterators.js
) provides a set of helpers simplify creating custom iterators:- Augment iterable with an iterator interface —
augmentIterator()
,normalizeIterator()
. - Add array-like methods if not present —
mapIterator()
,filterIterator()
.
- Augment iterable with an iterator interface —
- Path (
meta-toolkit/path.js
) provides a set of helpers to work with embedded objects in a simple way:- Get value from a nested object by path —
get()
. - Set value in a nested object by path —
set()
.
- Get value from a nested object by path —
- Options (
meta-toolkit/options.js
) provides a set of helpers to organize options for constructors:- Copy options according to some defaults —
copyOptions()
.
- Copy options according to some defaults —
- Comparators (
meta-toolkit/comparators.js
) provides a set of helpers to convert between different types of comparator functions:- Create a compare function from a less function and vice versa —
compareFromLess()
,lessFromCompare()
. - Create an equality function from a less function —
equalFromLess()
. - Reverse comparators —
reverseCompare()
,reverseLess()
.
- Create a compare function from a less function and vice versa —
See the full documentation in the wiki.
Generating names:
import {toCamelCase, toPascalCase, toSnakeCase,
toAllCapsSnakeCase, fromKebabCase} from 'meta-toolkit/names.js';
const names = fromKebabCase('foo-bar-baz');
console.log(toCamelCase(names)); // fooBarBaz
console.log(toPascalCase(names)); // FooBarBaz
console.log(toSnakeCase(names)); // foo_bar_baz
console.log(toAllCapsSnakeCase(names)); // FOO_BAR_BAZ
Aliasing properties:
import {addAliases} from 'meta-toolkit/aliases.js';
class Foo {
constructor() { this.value = 0; }
get double() { return this.value * 2; }
line(a, b) { return a * this.value b; }
}
addAliases(Foo.prototype, {
double: 'x2, duplicate',
line: 'linear'
});
const f = new Foo(2);
console.log(f.double); // 4
console.log(f.x2); // 4
console.log(f.linear(1, 2)); // 4
Object manipulation with paths:
import {set, get, remove, forceSet} from 'meta-toolkit/path.js';
const object = {};
forceSet(object, 'a.b.c', 1); // object = {a: {b: {c: 1}}}
get(object, 'a.b.c'); // 1
get(object, 'a'); // {b: {c: 1}}
set(object, 'a.b.c', 2); // object = {a: {b: {c: 2}}}
set(object, 'a.b.d', 3); // object = {a: {b: {c: 2, d: 3}}}
remove(object, 'a.b.c'); // object = {a: {b: {d: 3}}}
remove(object, 'a.b'); // object = {a: {}}
BSD 3-Clause "New" or "Revised" License. See the LICENSE file for details.
- 1.1.0 Added comparator utilities.
- 1.0.0 Initial release.