Campo minado guiado pelos padrões de projeto MVC e Strategy. O jogo foi desenvolvido com Python 3 e a interface gráfica utiliza a biblioteca Qt5 da linguagem.

Conforme os conceitos abordados na disciplina de Programação Orientada Objetos II da Universidade Federal de Itajubá ministrada pelo professor Phyllipe, a equipe desenvolveu um campo minado com a interface gráfica Qt5 aplicando os padrões de projeto MVC e Strategy. Acesse o vídeo Minewsweeper para uma explicação mais detalhada do processo de desenvolvimento deste projeto.

As orientações estão divididas nos seguintes tópicos:

• Minesweeper com designs pattern MVC e Strategy
  • Sobre
  • Funcionalidades ⚙️
  • MVC
  • Strategy 🤔
  • Pré-requisitos e configuração 🛠️
    • PyQt5
  • Layout 🎨
  • Tecnologias 🧑‍💻
  • Contribuidores

• Easy mode com MVC;
• Mid mode com MVC;
• Hard mode com MVC;
• Random mode (usuário insere as dimensões) com MVC;
• Implantar um timer básico;
• Timer utilizando os assets;
• Strategy para saves;
• Exportar save para JSON;
• Exportar save para CSV;
• Exportar save para TXT.

O núcleo da aplicação foi construída nas classes Model, View, Controller e Cell. O MVC funciona como um padrão de arquitetura de software que melhora a conexão entre as camadas de dados, lógica de negócio e interação com usuário. Através da sua divisão em três componentes, o processo de programação se torna algo mais simples e dinâmico. Como na aplicação do projeto utilizou-se uma interface gráfica, basear-se em um código monolítico juntaria todas as funções em um arquivo somente, o que tornaria a manutenção mais complicada. A fim de revolver este problema, separou-se em model, view e controller onde a criação da interface, a parte estética e sua configuração seriam referenciadas na view, enquanto toda a lógica do programa referenciaria-se na model.

• Cell: classe de suma importância, compõe as células que geram um campo minado (matriz) e armazena os atributos e funções essenciais para validar a lógica do jogo;

• Model: classe que implementa a lógica do jogo, define a estrutura e as funcionalidades, desde a definição do que tem no jogo até as dificuldades, formas de salvar, implementação de regras e tudo o que for necessário para o funcionamento do jogo;

• Controller: A controller funciona como uma ponte entre a View e a Model, seria mais um nível de abstração, fazendo com que a View utilize das funções da Model sem conhecê-las. No caso desse projeto a controller faz a chamada das funções da model quando um evento ocorre na view, por exemplo, se um jogador clica em uma determinada dificuldade na interface da view, ela chama a função da controller que cria um novo jogo nessa dificuldade, todavia, essa função da controller não implementa a criação desse novo jogo na nova dificuldade, ela apenas chama as funções da model necessárias para realizar tal tarefa passando os parâmetros da view, como a nova dificuldade;

• View: A View é a parte estética do projeto, implementa a interface gráfica e processa os eventos e interações do usuário chamando a controller, que por sua vez chama as funções que estão implementadas na Model, no nosso projeto toda a implementação da interface gráfica com PyQT está nessa classe;

Conforme o UML acima, foi necessário criar uma classe de contexto SaveGame, uma vez que python não reserva uma palavra chave para interfaces. Essa classe fica incumbida de conectar a model com a implementação do strategy pela classe (interface) TypeFile, permitindo que o usuário troque a implementação concreta do atributo TypeFile na model em tempo de execução.

O jogo permite que o usuário exporte o histórico de vitórias com o tempo de jogo para os arquivos do tipo: JSON, CSV e TXT.

Export do save como JSON:

No geral, para executar a aplicação é recomendado que o sistema já possua:

• Python3;
• Biblioteca Qt5;
• pyInstaller (se desejar gerar um executável para seu sistema);
• Git (opcional caso deseje clonar o repositório);
• Visual Studio Code (se desejar executar o jogo pelo terminal).

Vale ressaltar que um executável para Windows será disponilibizado na path Windows.

O campo minado foi testado nos seguintes sistemas operacionais (ambientes de desenvolvimento):

• Windows 10;
• Windows 11;
• Manjaro KDE;
• Ubuntu 18.04 LTS.

Para instalar a biblioteca em ambos os ambientes supracitados será necessário abrir um terminal (tanto o bash no Visual Studio Code quanto PowerShell no Windows Terminal servirão). Execute o comando abaixo para instalar a biblioteca:

pip install pyqt5

Para iniciar o jogo pelo terminal deve-se seguir as instruções abaixo.

# Clone este repositório com
$ git clone https://github.com/MatMB115/minesweeper_mvc_patterns_com221
# ou
$ git clone [email protected]:MatMB115/minesweeper_mvc_patterns_com221.git

# Acesse a pasta do projeto no seu terminal/cmd
$ cd minesweeper_mvc_patterns_com221

# Acesse a pasta do jogo
$ cd minesweeper

# Chame o interpretador do python 3 com o main.py

# Para linux
$ python3 main.py

# Para Windows
$ py main.py

# O jogo será iniciado corretamente

O jogo conta com uma tela principal que possui o campo minado usando assets inspirados no grandioso Minesweeper do Windows 95, um contador de bombas, um botão de status/start e um timer. Há também três botões na menubar para mudar o modo de jogo, exportar o histórico e sair da aplicação.

O ponto de início deste projeto foi um ambiente virtual python, as dependências utilizadas estão presentes abaixo.

Aplicação:

-> Python 3.10.8
- pyQt5
- pip
- pyInstaller
- Virtual environment
- csv
- json

Utilitários:

-> Dev
- Visual Studio Code 1.73
- PyCharm 2022.3

Matheus Martins 🧑‍💻

Breno Oliveira 🧑‍💻

Thais Souza 🧑‍💻

Matheus Luz 🧑‍💻

Repositório dedicado para o versionamento do campo minado desenvolvido usando os design patterns.