Merge pull request #2 from ReinanHS/feature/delivery-ag

fix:  correções para o algoritmo genético

.github/workflows/python.yml

@@ -0,0 +1,30 @@
+name: Validação do Python
+
+on: [push]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Instalar dependências
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r src/python/requirements.txt
+    - name: Analisando o código com pylint
+      run: |
+        pylint src/python/**/*.py
+      continue-on-error: true
+    - name: Verificação automática do formato do código
+      run: |
+        autopep8 --recursive --diff --aggressive --aggressive src/python
+    - name: Execução dos testes
+      run: |
+        pytest src/python

.gitignore

@@ -1,2 +1,4 @@
 .idea
-__pycache__/
+src/__pycache__/
+src/python/.pytest_cache/
+.eggs/

.pylintrc

@@ -0,0 +1,2 @@
+[MESSAGES CONTROL]
+disable=missing-module-docstring,missing-class-docstring,missing-function-docstring

doc/classroom-tasks/01-delivery-ag.md

@@ -61,7 +61,7 @@ Para mais detalhes sobre a atividade, recomendamos consultar o link abaixo:
 ## Soluções desenvolvidas
 
 - Solução simples
-  - [Python - Console](../../src/python/caixeiro-viajante-simple/index.md)
+  - [Python - Console](../../src/python/src/caixeiro_viajante_simple/index.md)
 
 ## Referências
 

src/python/.gitignore

@@ -0,0 +1,4 @@
+src/__pycache__
+src/*.egg-info
+src/delivery_ag/.cache
+src/delivery_ag/*.gif

src/python/README.md

@@ -0,0 +1,64 @@
+# Estrutura em Python
+
+Esta estrutura foi criada para realizar experimentos utilizando a linguagem de programação Python. Dentro deste diretório, você encontrará uma organização básica que permite a execução de todo o código desenvolvido com esta linguagem. É altamente recomendado que você siga os pré-requisitos para garantir que a execução ocorra corretamente no seu ambiente.
+
+## Requisitos
+
+Recomendamos que você tenha o [Conda](https://docs.conda.io/projects/conda/en/latest/index.html) instalado na sua máquina. Esta ferramenta facilita a criação de ambientes virtuais necessários para a execução do código. Caso você não tenha o Conda instalado, pode utilizar o interpretador padrão do Python. No entanto, a maioria dos testes deste projeto foram desenvolvidos utilizando ambientes gerados pelo Conda.
+
+---
+
+## Atenção
+
+Para executar os próximos comandos, recomendamos que você esteja no diretório correto do código Python. Geralmente, ao abrir este projeto, você verá a raiz principal do repositório. Entretanto, como o objetivo deste repositório é apresentar exemplos em diversas linguagens de programação, sugerimos que acesse especificamente o diretório referente ao Python antes de prosseguir com os comandos. O caminho para o diretório Python é:
+
+> src/python
+
+## Criação do ambiente virtual
+
+Para criar um ambiente virtual e executar o código, você pode seguir os passos abaixo:
+
+### Para usuários de Python 3:
+
+1. Instale o virtualenv:
+   ```bash
+   pip install virtualenv
+   ```
+2. Crie o ambiente virtual:
+   ```bash
+   virtualenv algoritmo_genetico_ifs
+   ```
+3. Ative o ambiente virtual:
+   ```bash
+   source caminho_para/algoritmo_genetico_ifs/bin/activate
+   ```
+
+### Para usuários do Anaconda:
+1. Crie um ambiente Conda:
+   ```bash
+   conda create --name algoritmo_genetico_ifs
+   ```
+2. Ative o ambiente Conda:
+   ```bash
+   conda activate algoritmo_genetico_ifs
+   ```
+3. Instale o pip no ambiente:
+   ```bash
+   conda install pip
+   ```
+
+## Execução dos testes
+
+Para executar os testes disponíveis neste projeto, siga os passos abaixo:
+
+1. Instale o pacote no modo de desenvolvimento:
+   ```bash
+   pip install -r src/python/requirements.txt
+   pip install -e .
+   ```
+2. Após a instalação, execute os testes com o seguinte comando:
+   ```bash
+   pytest src/python
+   pylint src/python/**/*.py
+   autopep8 --recursive --in-place --aggressive --aggressive src/python
+   ```