jinang

Collection of Node.js / ECMAScript Mini Modules

Other Languages / 敬请等待 / 敬請等待
If links in this document not avaiable, please access README on GitHub directly.

The name jinang is abbreviation of "Jin-Nang", which in chinese means a magic box. The modules in jinang are independent for each other, and are for different usage.

jinang is an incubator. Successful sub modules may be encouraged to be published as independent NPM packages.

Table of contents

• Get Started
• API
• Why jinang
• References

Links

• CHANGE LOG
• Homepage

Get Started

// Modules are independent for each other and are suggested to be required independently.
const defineError = require('jinang/defineError');

const MyError = defineError('MyError', Error, function(message) {
    this.code = 'SOMETHING_IS_WRONG';
    this.message = message;
});

// ...
throw new MyError('Helo word!');

API

All sub-modules in jinang are independent from each other. Use require('jinang/<subModuleName>') to require the sub-modules.

For your convenience, avaiable modules included in jinang are listed here (alphabetically sorted):

• absorb : Concatenate following array(s) to the firt one.
• cloneObject : Copy some / all properties from object and return a new one.
• co : A wrapper of generator function.
• currying : Make function curried.
• defineError : Create customised Error class.
• Directory : Make it easier to manage a directory.
• forInObject : The combination of For...In and For...Of.
• isGenerator : Judge whether it is a Generator.
• isGeneratorFunction : Judge whether it is a Generator Function.
• jointString : Concatenate strings with specified joint.
• JsonFile : Wrapper of a JSON file.
• modifyUrl : Modify URLs.
• open : Open URI with matched application.
• ordinal : Acquire the ordinal form of a natural number.
• ott : Wrap a function to allow it invoked only once, twice or thrice.
• papply : Partial application of a function.
• parseOptions : Intelligently parse an option object.
• PoC : Promise or Callback.
• Progress : Progress simulator.
• promiseRejectionAutoHandle : Avoid console warning when no cather defined.
• safeClone : A deep and partial clone method.
• sleep : Make current process to "sleep" for a while.
• split : Split string in different ways.
• TxtFile : Wrapper of a .txt file.
• unescaping : A tiny and flexible template render.

Why jinang

jinang is an incubator for creatives which will make programming with Node.js much easier.

Only mini modules without any dependencies may be put into jinang. Although every module is small enough, they all will be maintained carefully and seriously.