艾克斯の编码者

一个伪宅级别的码畜。

让我们一起来起花名吧

大纲
  1. 1. 起因
  2. 2. 准备
    1. 2.1. Chinese Random Name
      1. 2.1.1. 基本用法
      2. 2.1.2. 高级用法
    2. 2.2. Nomnom
    3. 2.3. Colorful
    4. 2.4. Is Chinese
    5. 2.5. 集合
  3. 3. 开工
    1. 3.1. 解析命令行参数
    2. 3.2. 花名类
      1. 3.2.1. 构造函数
      2. 3.2.2. 生成一个花名
      3. 3.2.3. 生成 Count 个花名
    3. 3.3. CLI 文件
      1. 3.3.1. 桥豆麻袋!
  4. 4. 收拾

起因

起因是我一个叫『小龙』的好基友由于某些原因离职去了一家跟阿里一样有着『花名文化』的公司,于是开始为花名犯愁。

结合之前妹纸『弍纾』在起花名的时候也遇到了同样的困扰,于是决定用 Node.js 写个『一本正经乱起花名』的程序。

准备

Chinese Random Name

首先起花名的原理就是胡乱随机一串字出来胡乱拼。

于是准备应该有 chinese-random-name,一个随机生成中文名的包。

使用它很简单,先把它 require 进来:

const randomName = require("chinese-random-name");

基本用法

如果你需要随机生成一个名字只需要 randomName.generate() 就可以了;如果你要随机一个姓那么就 randomName.surnames.getOne();如果你只需要获得名字,这里面就有点门道了。

高级用法

你可以随机生成一个名(不带姓的) randomName.names.get();你也可以指定名字的字数,一二三:

randomName.names.get1();
randomName.names.get2();
randomName.names.get3();

或者!

又或者!

然后或者!

你可以指定每个字的五行哦!

什么意思呢?比如你想给孩子起个名,然后孩子命里五行缺金,那么就可以:

randomName.names.get2("金金");

然后你就可能得到一个『紫铨』,两个字都是属金的。那么如果你孩子姓李,就叫李紫铨;如果孩子姓王,就叫王紫铨;如果姓爱新觉罗,那么就叫爱新觉罗·紫铨。

有木有想给我装得这个逼打个 82 分呢?剩下的就交给 666 吧。(ง •̀_•́)ง

Nomnom

这个包是用来解析命令行参数的。虽然市面上有挺多别的的,比如 commander 等,不过我还是最习惯 nomnom,用称手了就不想换了。

虽然它的 GitHub Repo 下面有这么一段话。

Nomnom is deprecated. Check out https://github.com/tj/commander.js, which should have most, if not all of the capability that nomnom had. Thank you!

不过再怎么说 nomnom 也是当年 substack 大神推荐的啊。(ಡωಡ)

Colorful

这个包是用来上色的。

毕竟五行是有颜色的哇。

const color = require("colorful");
console.log(color.red("(*/∇\*)"));

那么在你的终端就好看到一个红色的 (*/∇\*)

Is Chinese

用来判断是不是中文的包。

作为一个起名的命令行程序,你总得好好传参才行吧,总不能你随便传个咸鸭蛋🐣我也好好处理吧。

于是就用 is-chinese 来判断某个字符串是不是纯中文。

这个包是由前阿里小伙伴,CNode 站长唐少写的。

用起来也很简单,只要 isChinese("什么你要判断什么") 就可以了。

集合

$ npm install --save -d chinese-random-name
$ npm install --save -d nomnom
$ npm install --save -d colorful
$ npm install --save -d is-chinese

开工

其结果在这里

解析命令行参数

首先效果是这样的:

$ hua --help

Usage: hua [options]

Options:
-p PREFIX, --prefix PREFIX to specify a prefix.
-s SUFFIX, --suffix SUFFIX to specify a suffix.
-5 WUXING, --five-elements WUXING the file elements (Wuxing) of huaming.
-c COUNT, --count COUNT the count of huaming [10]

使用者可以自己想一个前缀或者后缀,然后自定义(或者也可以不指定)两个字的五行,以及指定一次性生成多少个花名。

比如想要生成以 字为前缀的花名,就可以 $ hua --prefix 龙,得到结果可以是这样的:

* 龙幼
* 龙巡
* 龙躬
* 龙仇
* 龙锤
* 龙镒
* 龙拾
* 龙央
* 龙些
* 龙悠

如果想两个字分别所属金和谁,就可以 $ hua --five-elements 金水 来起花名:

* 倩娥
* 雀效
* 黍棓
* 姹溶
* 馨沙
* 宫闲
* 裕混
* 俗封
* 绸娥
* 瑞淦

想要得到这样一个命令行参数,我们可以用 nomnom 来解决。

var opts = require("nomnom")
.script("hua")
.option("prefix", {
abbr: "p",
help: "to specify a prefix.",
metavar: "PREFIX"
})
.option("suffix", {
abbr: "s",
help: "to specify a suffix.",
metavar: "SUFFIX"
})
.option("five-elements", {
abbr: "5",
help: "the file elements (Wuxing) of huaming.",
metavar: "WUXING"
})
.option("count", {
abbr: "c",
help: "the count of huaming",
metavar: "COUNT",
default: 10
})
.parse();

上面的这段代码分别指定了脚本名为 hua,然后指定了 prefix / suffix / five-elementscount 四个参数,并把解析好的参数赋值给 opts 变量。

由于我希望这个包在通常的 Node.js 下都可以跑,所以没有用 let 之类的东西。

花名类

接下去要写一个花名类,这个类不只是可以在 CLI 之中使用,也可以让别人作为一个包来引入。然后实际上这个类就是要对 chinese-random-name 进行一个封装。

构造函数

var Hua = function(options) {
this.options = options;

// Do something...
};

首先这个 options 就是之前由 nomnom 解析出来的参数,当然有些参数是可选的。

接下去我们要在构造函数也就是 Hua 里面格式化前缀或者后缀(如果有的话),将他们弄成只有一个汉字的格式。

if(options.prefix) {
options.prefix = options.prefix[0];
if(!isChinese(options.prefix)) delete options.prefix;
}

if(options.suffix) {
options.suffix = options.suffix[0];
if(!isChinese(options.suffix)) delete options.suffix;
}

前后缀弄好之后要对五行进行分析了。

如果有前后缀那么忽略五行参数。

if(options.prefix && options.suffix) {
delete options["file-elements"];
}

如果有前缀,那么忽略传进来的五行的第一个五行;如果有后缀那么忽略第二个字的五行。

var wuxing = "金木水火土";

.
.
.

} else if(options.prefix) {
options["five-elements"] = options["five-elements"].substr(1, 1);
if(-1 === wuxing.indexOf(options["five-elements"])) {
delete options["five-elements"];
}
} else if(options.suffix) {
options["five-elements"] = options["five-elements"].substr(0, 1);
if(-1 === wuxing.indexOf(options["five-elements"])) {
delete options["five-elements"];
}
}

如果前后缀都没有,那么要格式化一下该参数,使其仅剩两个有效的五行汉字。

} else {
options["five-elements"] = options["five-elements"].substr(0, 2).split("");
for(var i = 0; i < options["five-elements"].length; i++) {
// 如果是无效五行或者冰没有这个字的话,随机一个五行出来
if(-1 === wuxing.indexOf(options["five-elements"][i])) {
options["five-elements"][i] = wuxing[Math.floor(Math.random() * 5)];
}
}

// 字数不够,随机来凑
while(options["five-elements"].length < 2) {
options["five-elements"].push(wuxing[Math.floor(Math.random() * 5)]);
}

options["five-elements"] = options["five-elements"].join("");
}

以上的这些逻辑都写在构造函数里面,如果想要完整的构造函数可以看 huahua.js 文件。

生成一个花名

生成一个花名其实就是调用 randomName.names.get 系列函数们了。

注意:以上情况都会传进(哪怕是 undefined)五行参数。

所以 generateOne 函数长这样

Hua.prototype.generateOne = function() {
if(this.options.prefix && this.options.suffix) {
return this.options.prefix + this.options.suffix;
}

if(this.options.prefix) {
debug(this.options["five-elements"]);
return this.options.prefix + randomName.names.get1(this.options["five-elements"]);
}

if(this.options.suffix) {
debug(this.options["five-elements"]);
return randomName.names.get1(this.options["five-elements"]) + this.options.suffix;
}

return randomName.names.get2(this.options["five-elements"]);
};

生成 Count 个花名

还记得 CLI 的 count 参数么?因为为了方便,我们可以批量生成花名,所以就需要生成 Count 个花名的函数了。

实际上就是一个循环调用 generateOne 的函数而已。

Hua.prototype.generate = function(count) {
if(!count) count = this.options.count || 10;

var result = [];
for(var i = 0; i < count; i++) {
result.push(this.generateOne());
}
return result;
};

CLI 文件

刚刚那个 nomnom 解析就在这个文件里面,然后接下去就是实例化一个 Hua 对象,然后生成 count 个花名。

var hua = new Hua(opts);
var result = hua.generate();

最后把花名输出来就好了。

for(var i = 0; i < result.length; i++) {
console.log(" * " + result[i]);
}

桥豆麻袋!

说好的五行颜色呢?!

好像是的哦,我们要在输出之前给 result 上个色儿。

遍历 result 里面的花名每个字,获取它的五行属性,然后涮上色儿。

chinese-random-name 暴露了字典中每个字的五行属性,只需要赋值一下就好了。

var dict = require("chinese-random-name").names.dict;

然后逐一对比。最后对应金木水火土的颜色值分别为:

var definedColors = [
220, 83, 26, 197, 59
];

220 为黄色,代表金;83 为绿色,代表木;26 蓝色代表水;197 红色代表火;59 灰色代表土。

如果那个字无法找到属性,则不上色,保持默认。

result = result.map(function(name) {
var withColor = "";

for(var i = 0; i < 2; i++) {
for(var j = 0; j < wuxing.length; j++) {
var wx = wuxing[j];
if(wx === " ") {
withColor += name[i];
break;
}

if(dict[wx].indexOf(name[i]) !== -1) {
var color = new Color(name[i]);
color.fgcolor = definedColors[j];
withColor += color.toString();
break;
}
}
}

return withColor;
});

至此我们的 CLI 就写好了,最后别忘了在 hua 这个 CLI 文件顶部加上一句话。

#!/usr/bin/env node

这代表到时候如果要 ./hua 的时候这个脚本是用 Node.js 来跑的。

收拾

本来想好好写篇起花名的牢骚,结果不知不觉写成了给初心者看的初级教程了,泪目 ( •̥́ ˍ •̀ू )

不嫌弃的就这么看看吧。

最后这里给出我写好的这个 hua 程序。

$ [sudo] npm install -g huaming

然后就能在命令行下面跑了,跑法上面几章有介绍过。它的 Repo 在这里

最后希望这个包在你们起花名的时候还真有那么一丢丢的用处。