[![NPM version][npm-image]][npm-url]
[![Build Status][travis-image]][travis-url]
[![Dependency Status][daviddm-image]][daviddm-url]
[![Coverage percentage][coveralls-image]][coveralls-url]
Yeoman generator para gerar plugins para o projeto ES na palma da mão usando jspm.
Primeiro, instale yeoman, jspm CLI, jspm Server
e então generator-espm-plugin
usando npm (assumindo que você tem node.js e npm instalados).
npm i -g yo jspm jspm-server generator-espm-plugin
mkdir meu-plugin & cd meu-plugin
Opcionalmente bloqueie a versão do jspm para o projeto:
cd meu-plugin
npm install jspm --save-dev
É aconselhável instalar jspm localmente para bloquear a versão do jspm para o plugin. Essa medida garante que eventuais atualizações ao jspm global não interfiram no comportamento do plugin. Use
jspm -v
para ver a versão local instalada.
Execute generator-espm-plugin
dentro do diretório criado, opcionalmente informando o nome do plugin:
yo espm-plugin [nome do plugin]
Se o nome do plugin não for informado, o nome do plugin será o nome do diretório onde o generator está sendo executado.
O generator fará as seguintes perguntas:
Pergunta: Por favor digite seu username do Github:
Digite seu nome de usuário do GitHub (obrigatório), o qual será usado para configurar o jspm.
Pergunta: Deseja executar o plugin imediatamente após a instalação? (Yn)
Responda sim (Y ou y) para iniciar um servidor local, abrir uma janela do browser e exibir o recém-criado plugin imediatamente após a instalação.
Repare que
generator-espm-plugin
emula uma versão de desenvolvimento lightweight da aplicação ES na palma da mão e executa o plugin no contexto dessa aplicação.
Pergunta: Qual o "module system" usado pelo plugin?
Selecione ES6 para usar a sintaxe e o sistema de módulos do ECMAScript 2015 ou selecione
CommonJS para usar o sistema de módulos CommonJS, como usado tradicionalmente usado no módulos do node.js.
Indepentemente do sistema de módulos escolhido, o conjunto jspm + systemjs vai fazer a requisição assíncrona dos seus scripts dentro
do seu plugin à medida que você os requisitar, seja através de require(xxxx)
(CommonJS) ou import xxx from 'XXXXX'
(ES6).
Pergunta: Deseja criar unit tests?
Escolha sim (Y ou y) para gerar configurações de teste e testes unitários de exemplo para o plugin.
Exemplos:
jspm install jquery
jspm install myname=npm:underscore
jspm install github:components/jquery
jspm install npm:lodash-node
Abaixo seguem breves descrições das ferramentas utilizadas no projeto:
- yeoman é uma ferramenta de scaffolding de aplicações web modernas.
- jspm CLI é um package manager para o browser.
- jspm Server é um servidor local que será usado para rodar seu plugin em desenvolvimento.
gulp link
gulp deploy
Este comando irá criar um tagged commit seguido de push para o repositório do plugin no Github.
Leia mais sobre Yeoman sobre Yeoman.
MIT © PRODEST [npm-image]: https://badge.fury.io/js/generator-espm-plugin.svg [npm-url]: https://badge.fury.io/js/generator-espm-plugin [travis-image]: https://travis-ci.org/prodest/generator-espm-plugin.svg [travis-url]: https://travis-ci.org/prodest/generator-espm-plugin [daviddm-image]: https://david-dm.org/prodest/generator-espm-plugin.svg?theme=shields.io [daviddm-url]: https://david-dm.org/prodest/generator-espm-plugin [coveralls-image]: https://coveralls.io/repos/prodest/generator-espm-plugin/badge.svg [coveralls-url]: https://coveralls.io/r/prodest/generator-espm-plugin