Organizar regras e requisitos

[alfredo003]

1. Requisitos Gerais

Normas de Código

• O código deve seguir as normas de código da 42, respeitando regras de estilo e organização de arquivos.
• Erros de norma resultarão em nota zero na avaliação final do projeto.

Tratamento de Erros

• A shell foi projetada para ser resiliente a erros. Não deve encerrar inesperadamente, evitando falhas comuns como segmentation faults, double frees, entre outros.

Gerenciamento de Memória

• Todo espaço de memória alocado na heap deve ser liberado corretamente antes do encerramento da shell.
• Vazamentos de memória (memory leaks) não são tolerados e podem resultar em penalizações severas na avaliação.

Makefile

• O projeto inclui um Makefile para a compilação automatizada, configurado com as flags -Wall, -Wextra, e -Werror para ajudar na detecção de erros e advertências.
• O Makefile deve conter as seguintes regras:
  • all: Compila todos os arquivos necessários para o projeto.
  • clean: Remove arquivos temporários ou objetos.
  • fclean: Remove arquivos temporários, objetos e o binário final.
  • re: Reconstrói o projeto desde o início, garantindo uma compilação limpa.
  • bonus: Regras para funcionalidades extras.

Biblioteca Libft

• A biblioteca libft deve ser incluída e compilada junto com o projeto, se permitido. Essa biblioteca fornece funções auxiliares essenciais para o desenvolvimento do projeto.

[alfredo003]

2. Parte Obrigatória

• Nome do Programa: minishell

• Prompt:

  • O shell exibe um prompt e aguarda a entrada de comandos do usuário.

• Histórico de Comandos:

  • Mantém um histórico dos comandos executados, permitindo fácil navegação para comandos anteriores.

• Execução de Comandos:

  • Executa comandos fornecidos pelo usuário, buscando o executável correto no PATH ou por meio de um caminho relativo/absoluto.

• Variáveis de Ambiente:

  • Interpreta e expande variáveis de ambiente (por exemplo, $PATH), permitindo o uso de variáveis nas entradas de comando.

• Redirecionamentos:

  • < : Redireciona a entrada de um arquivo.
  • > : Redireciona a saída para um arquivo.
  • << (heredoc): Lê entrada até um delimitador definido pelo usuário.
  • >> : Redireciona a saída para um arquivo em modo append.

• Pipes:

  • Permite a conexão de comandos usando pipes (|), permitindo a execução de uma cadeia de comandos onde a saída de um comando é passada como entrada para o próximo.

• Sinais:

  • Ctrl+C: Interrompe o comando em execução e exibe um novo prompt.
  • Ctrl+D: Encerra o shell.
  • Ctrl+\: Nenhuma ação é realizada.

Built-ins Implementados

Os seguintes comandos internos (built-ins) foram implementados diretamente na minishell:

1. echo: Exibe uma string no terminal. Suporta a opção -n para suprimir a nova linha.
2. cd: Muda o diretório atual para o caminho especificado (relativo ou absoluto).
3. pwd: Exibe o diretório de trabalho atual.
4. export: Define ou altera variáveis de ambiente.
5. unset: Remove variáveis de ambiente.
6. env: Exibe todas as variáveis de ambiente.
7. exit: Encerra o shell.