Sobre

Este é um simples projeto em python para utilizar o banco de dados mongodb com a biblioteca pymongo.

🚧 Em construção para a realização de testes 🚧

Tabela de conteúdos

• Sobre
• Tabela de conteúdos
• Tecnologias utilizadas
• Como executar o projeto
  • Pré-requisitos
  • Executando os comandos
  • Criando o banco de dados
  • Executando os testes
• Autor
• Licença

💻 Tecnologias utilizadas

• Python
• Docker
• Pymongo

🚀 Como executar o projeto

Pré-requisitos

• É preciso que você tenha o python e o Docker já instalados.
• (Opcional): Utilize um editor de texto de sua preferência para escrever e executar os códigos.
• (Opcional): Utilize o MongoDB Compass para facilitar a visualização dos dados no mongodb.

Executando os comandos

    # Criar um ambiente virtual no python para instalação das bibliotecas a serem utilizadas.
    $ python -m venv venv
    
    # Selecionando o ambiente virtual criado.
    $ .\venv\Scripts\activate
    
    # Instalar as dependências do projeto.
    $ pip install -r requirements.txt
    
    # Criar um arquivo ".env" no diretório atual do projeto com as seguintes variáveis:
    MONGODB_HOST=endereço do host (Ex: localhost).
    MONGODB_PORT=porta do serviço do banco de dados (Ex: 27017).
    MONGODB_USER=nome do usuario de acesso ao banco de dados (Ex: admin).
    MONGODB_DBNAME=nome do banco de dados padrão a ser iniciado no serviço (Ex: admin).
    MONGODB_PASSWORD=senha do usuário de acesso ao banco de dados (Ex: s3nh@).
    
    # Iniciar o container com o serviço do banco de dados.
    $ docker-compose up
    

Criando o banco de dados

• Acessar o MongoDB Compass
• Criar uma nova conexão:

  

• Criar o banco de dados com o nome "test" e a coleção com o nome "contatos":

  

Executando os testes

    # Executa os testes com as funções escritas em python.
    $ python .\test_functions.py

Resultado: os testes consistem em realizar as operações de CRUD no banco de dados na seguinte ordem:

• Insert de um documento na coleção "contatos".
• Busca do documento inserido anteriormente.
• Update do documento inserido inicialmente.
• Delete do documento inserido inicialmente.

Antes da execução da operação de delete, é possível consultar no MongoDB Compass o documento inserido inicialmente.

Ao final da execução o documento inserido é deletado, ficando sem nenhum registro no banco de dados.

---

🦸 Autor

Desenvolvido por Tiago Ajala Mielnik.

---

📝 Licença

Licença MIT.