# Plop —— 小而美的脚手架工具

# Plop介绍

主要用于创建项目中特定文件类型的小工具，类似于Yeoman中的sub generator，一般不会独立使用。一般会把Plop集成到项目中，用来自动化的创建同类型的项目文件。

# Plop的具体使用

# 具体步骤

新建目录，初始化npm init -y，安装Plop

npm install -g plop

在目录下创建plop-templates文件夹，里面创建三个模板文件

component.css.hbs

.{{name}} {
  
}

1
2
3

component.hbs

import React from 'react';

export default () => (
  <div className="{{ name }}">
    <h1>{{name}} Component</h1>
  </div>
)

1
2
3
4
5
6
7

component.test.hbs

import React from 'react';
import ReactDOM from 'react-dom';
import {{name}} from './{{name}}';

it('renders widthout crashing', () => {
  const div = document.createElement('div');
  ReactDOM.render(<{{name}} />, div);
  ReactDOM.unmountComponentAtNode(div);
});

1
2
3
4
5
6
7
8
9

在根目录下创建一个plopfile.js的文件，这个文件是Plop的入口文件，需要导出一个函数，这个函数接收一个plop对象，用于创建生成器任务。

plop.setGenerator：设置一个生成器，第一个参数是项目名称，第二个函数是对象，对应设置选项

配置项内容：
description：描述

prompts：值是数组，命令行交互问题，一个问题对应一个对象

actions：值是数组，完成命令行交互过后完成的一些动作，一个对象一个动作

module.exports = plop => {
  // 设置一个生成器，第一个参数是项目名称，第二个函数是对象，对应设置选项
  plop.setGenerator('compontent', {
    // 描述
    description: 'create a component',
    // 命令行交互问题
    prompts: [
        // 一个问题对应一个对象，配置参考自定义Generator
      {
        type: 'input',
        name: 'name',
        message: 'component name',
        default: 'MyComponent'
      }
    ],
    // 完成命令行交互过后完成的一些动作
    actions: [
      //每一个对象都是一个动作
      {
        type: 'add', // 代表添加文件
        // 被添加的文件在输出的哪个路径，双花括号插值表达式可以获取交互得到的数据
        path: 'src/components/{{name}}/{{name}}.js',
        // 模板文件是什么
        templateFile: 'plop-templates/component.hbs'
      },
      {
        type: 'add',
        path: 'src/components/{{name}}/{{name}}.css',
        templateFile: 'plop-templates/component.css.hbs'
      },
      {
        type: 'add',
        path: 'src/components/{{name}}/{{name}}.test.js',
        templateFile: 'plop-templates/component.test.hbs'
      }
    ]
  })
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

在package.json中添加

  "scripts": {
    "plop": "plop"
  }

1
2
3

运行

npm run plop
# 输入模块名称
? component name Header
#√  ++ \src\components\Header\Header.js
#√  ++ \src\components\Header\Header.css
#√  ++ \src\components\Header\Header.test.js

1
2
3
4
5
6

此时在根目录的src\components下面，有了三个文件

Header.js

import React from 'react';

export default () => (
  <div className="Header">
    <h1>Header Component</h1>
  </div>
)

1
2
3
4
5
6
7

Header.css

.Header {
  
}

1
2
3

Header.test.js

import React from 'react';
import ReactDOM from 'react-dom';
import Header from './Header';

it('renders widthout crashing', () => {
  const div = document.createElement('div');
  ReactDOM.render(<Header />, div);
  ReactDOM.unmountComponentAtNode(div);
});

1
2
3
4
5
6
7
8
9

这样，就可以根据模板一键生成一个组件目录。

# 总结

将plop模块作为项目开发依赖安装
编写用于生成特定类型文件的模板
在项目根目录下创建一个plopfile.js文件
在plopfile.js文件中定义脚手架任务
通过Plop提供的CLI运行脚手架任务