Folder Structure

Folder Structure é um projeto criado para simplificar a organização de pastas e a geração de arquivos em projetos Node.js. Ele oferece uma interface de linha de comando (CLI) e funções que automatizam essas tarefas, proporcionando uma estrutura padronizada e eficiente para o desenvolvimento de aplicações.

Folder Structure is a project designed to simplify folder organization and file generation for Node.js projects. It provides a command-line interface (CLI) and functions to automate these tasks, offering a standardized and efficient structure for application development.

Instalação | Installation

Instale o pacote em seu projeto com o seguinte comando:

Install the package in your project directory with the following command:

1
2npm  i  @rgcabral/folder-structure
3npm  i  @rgcabral/folder-structure  -g (functions and  imports  are  unavailable)
4
5## ou | or
6
7yarn  add  @rgcabral/folder-structure
8

Utilização | Utilization

A CLI é utilizada para a criação de formatações iniciais e oferece funções de suporte que automatizam a criação de padrões estruturais no seu projeto. Com apenas alguns comandos, você pode gerar uma estrutura organizada e eficiente para facilitar o desenvolvimento.

The CLI is used to create initial formatting and provides support functions to automate the creation of structural patterns in your project. With just a few commands, you can generate an organized and efficient structure to streamline development.

CLI

comando inicial: | Initial command:

1
2npx folder-structure <dist> -l  typescript
3

ou (em caso de instalação global) | or (in case of global installation):

1
2folder-structure <dist> -l  typescript
3

Ajuda: | Help:

1
2Examples:
3
4$  folder-structure  ./  --language  typescript  --structure  node
5
6$  folder-structure  ./  --language  javascript  --structure  react
7
8$  folder-structure  ./  -l  javascript  -s  node
9
10Argument:
11
12-  `<dist>`: The destination directory where the structure will be created.
13			 It is recommended to use `./` to generate the structure in the current directory.
14
15  
16
17Available  languages:
18
19-  typescript:  Generates  files  in  TypeScript
20
21-  javascript:  Generates  files  in  JavaScript
22
23- (DEFAULT): typescript
24
25  
26
27Available  structures:
28
29-  node:  Organizes  files  for  a  Node.js  project
30
31-  react:  Organizes  files  for  a  React  project
32
33- (DEFAULT): node
34

após comando inicial: | after initial command:

1
2npm install
3

Funções | Functions

indisponível em caso de instalação global unavailable in case of global installation

---

createRawStructureApiNode(language, name, [rootPath])

Descrição

Cria uma estrutura para um novo módulo na API (rota, controlador, serviço e repositório), apenas a estrutura sem conteúdos.

Description

Creates a structure for a new module in the API (route, controller, service, and repository), structure only without contents.

---

createStructureCRUDNode(language, name, [rootPath])

Descrição

Cria uma estrutura para um novo módulo na API (rota, controlador, serviço e repositório), estrutura com conteúdos.

Description

Creates a structure for a new module in the API (route, controller, service, and repository), structure with contents.

---

listFilesAndDirectories([directoryPath], [indent])

Descrição

Lista a estrutura do diretório em formato JSON e em outro formato de texto.

Description

Lists the directory structure in both JSON format and another text format.

---

updateGeneratedStructure()

Descrição

Atualiza o texto da estrutura de pastas e arquivos gerados.

Description

Updates the text of the generated folder and file structure.

Integração | Integration

NODE

A biblioteca Folder-Structure é compatível com as principais bibliotecas e plugins utilizados na criação de servidores backend com Node.js, facilitando a organização do projeto e a integração com ferramentas populares, como:

The Folder-Structure library is compatible with key libraries and plugins commonly used in the development of backend servers with Node.js. It simplifies project organization and integrates seamlessly with popular tools such as:

• Fastify
  • @fastify/jwt
  • @fastify/cors
• Dotenv
• Knex

REACT

Inicie um projeto Vite com o comando inicial: | Start a Vite project with the initial command:

1
2$ npm create vite@latest
3

A biblioteca Folder-Structure se integra ao Vite e é compatível com as principais ferramentas utilizadas na criação de projetos frontend com React. Ela auxilia na criação de estruturas de pastas, facilitando a organização do projeto e a integração com ferramentas populares, como:

The Folder-Structure library integrates with Vite and is compatible with key tools used in frontend development with React. It assists in creating folder structures, simplifying project organization, and ensuring seamless integration with popular tools such as:

• Vite
• Axios
• React Router Dom

Recomendação | Recommendation

Os pacotes estão em versões fixas e, possivelmente, desatualizadas. Recomenda-se reinstalar os pacotes nas versões mais recentes, removendo as dependências do package.json e, em seguida, instalando novamente.

The packages are locked to fixed versions and may be outdated. It is recommended to reinstall the packages with newer versions by removing the dependencies from package.json and then reinstalling them.

Aviso | Warning ⚠️

• Em Desenvolvimento 🚨⚠️

  • Mais funções de suporte

• In Development 🚨⚠️

  • More support functions