crudcreator
v1.0.0
Published
---
Downloads
4
Readme
CRUDCREATOR CLI
Uma CLI (Interface de Linha de Comando) para gerar automaticamente um CRUD completo para APIs em Node.js utilizando Knex.js e Express. Este projeto acelera o desenvolvimento, criando rapidamente rotas, controladores e modelos para operações CRUD básicas.
Funcionalidades
- Geração Automática: Cria rotas, controladores e modelos para uma API CRUD em segundos.
- Configuração do Knex.js: Gera automaticamente o arquivo de configuração do Knex.js.
- Integração Simplificada: Adiciona as novas rotas ao arquivo
index.js
da aplicação. - Feedback Visual: Exibe uma animação de loading enquanto o CRUD está sendo gerado, proporcionando uma experiência de uso amigável.
Instalação
1. Clone o Repositório
Clone o repositório do projeto para sua máquina local:
git clone https://github.com/DsK-David/crudcreator.git
npm install crudcreator -g
2. Acesse o Diretório do Projeto
Navegue até o diretório do projeto:
cd crudcreator
3. Instale as Dependências
Instale todas as dependências necessárias:
npm install
4. Instale o CLI Globalmente
Para usar a CLI em qualquer lugar do seu sistema, instale-a globalmente:
npm install -g .
Uso
Depois de instalada, a CLI pode ser usada para gerar um CRUD completo para sua API com o comando:
crudcreator <host> <user> <password> <database> <modelName> <tableName>
Parâmetros
<host>
: O host do banco de dados MySQL.<user>
: O nome de usuário do banco de dados MySQL.<password>
: A senha do banco de dados MySQL.<database>
: O nome do banco de dados MySQL.<modelName>
: O nome do modelo a ser criado (ex:User
).<tableName>
: O nome da tabela no banco de dados MySQL (ex:users
).
Exemplo de Uso
Para gerar um CRUD para a tabela users
com um modelo chamado User
, execute:
crudcreator localhost root password mydatabase User users
Estrutura do Projeto
Ao executar o comando, a seguinte estrutura de diretórios será criada:
crud/
├── controllers/
│ └── UserController.js
├── models/
│ └── User.js
├── routes/
│ └── UserRoutes.js
├── knexfile.js
└── index.js
controllers/
: Contém os controladores com métodos para manipular as tabelas.models/
: Contém os modelos com métodos para realizar operações CRUD nas tabelas.routes/
: Contém as rotas da API para acessar os métodos dos controladores.knexfile.js
: Arquivo de configuração do Knex.js.index.js
: Arquivo principal onde as rotas são registradas.
Contribuição
Contribuições são bem-vindas! Siga os passos abaixo para contribuir:
- Faça um fork do repositório.
- Crie uma branch para suas alterações (
git checkout -b feature/sua-feature
). - Commit suas alterações (
git commit -m 'Adiciona nova funcionalidade'
). - Envie para a branch (
git push origin feature/sua-feature
). - Abra um pull request.
Licença
Este projeto está licenciado sob a MIT License.
Contato
Se tiver alguma dúvida ou sugestão, entre em contato através do e-mail [email protected].
Publicação no NPM
Instalação Global
Depois de instalar o projeto localmente, você pode instalar o CLI globalmente com:
npm install -g .
Publicando no NPM Registry
Login no NPM
Faça o login na sua conta do NPM:
npm login
Publicação do Pacote
Certifique-se de estar no diretório raiz do projeto e execute:
npm publish
Nota: Não se esqueça de atualizar o número da versão no package.json
antes de publicar uma nova versão.