Espresso Labs ionic-module

Esquema para novos módulos ionic internos da Espresso Labs

Compartilhar código entre equipes é sempre complexo. Garantir que isso seja feito de forma eficiente e fácil é de extrema importância para o crescimento do time como um todo.

Este projeto tem como objetivo fornecer as linhas gerais para publicação de novos módulos que possam se acoplar a projetos Ionic dentro da Espresso Labs

Instalação

npm i @espressolabs/ionic-module

E então faça a importaçao no seu app.module.ts

Usando

Para usar, basta clonar o projeto executando:

git clone https://[email protected]/_espresso/ionic-module.git

E inserir em src/components o código do seu componente, ou src/providers o código do seu provider/service, com atenção nas importações e em excluir os arquivos de exemplo.

Também é possível renomear arquivos ou inserir pastas adicionanis a partir do utils.js localizado na pasta util.

Testes

Os testes unitários são feitos com base no Karma, a biblioteca recomendada para testes em componentes Angular/Ionic. Para executá-los use o comando:

npm run test

Todos os testes são feitos com o Karma.

Todas as funções devem ser testadas, com code coverage de 100%

Publicando

Após garantir que todos os testes passam, caso o seu módulo esteja pronto para publicação inicie substituindo no package.json as entradas:

{
	"name": "*nome do seu módule*",
	"version": "*código de versão*",
	"description": "*Descrição geral*",
	"repository": {
		"type": "git",
		"url": "*endereço do repositório*"
	},
	"author": "*nome do autor/time*",
	"homepage": "*endereço web para mais informações*",
}

Em seguida, execute o comando:

npm publish

Se você nunca publicou um módulo, será necessário criar uma conta no NPM e fazer login.

Pronto, seu novo módulo foi publçicado e pode ser usado por todos.

Contribuindo

Para realizar mudanças, basta clonar o repositório, criar uma nova branch com suas mudanças e realizar um pull-request.

Utilitários

A pasta util do repositório contêm um script utilitário com alguns comandos para te ajudar a fazer a customização do seu novo módulo. Os comando tem sempre a seguinte forma:

node util.js (command) [args]

Rename

Você pode facilmente renomear qualquer elemento do seu módulo com o comando rename:

node util.js rename currentName newName

Para renomear apenas partes especifícas, basta adicionar o prefixo após os nomes, deste moddo:

node util.js rename currentComponent newComponent # renomeia um componente
node util.js rename currentProvider newProvider # renomeia um provider
node util.js rename currentModule newModule # renomeia apenas as entradas do módulo

Provider

Com o comando provider é possível adicionar novos providers ao projeto:

node util.js provider name

Assim, um novo provider com toda a estrutura necessária foi adicionado a pasta providers.

Links

Este projeto foi baseado no https://github.com/trekhleb/angular-library-seed

Referências durante o desenvolvimento

https://devdactic.com/custom-ionic-module-npm/
https://www.joshmorony.com/an-in-depth-explanation-of-providers-in-ionic-2/
https://ionicframework.com/docs/v3/api/IonicModule/

Licença

Este projeto só pode ser compartilhado entre projetos da Espresso Labs, de acordo com o código de conduta.

© Espresso Labs 2019