Trabalho de Compiladores - Geração de Código HTML para Cartas Yu-Gi-Oh!

Realizador

• Árlisson Alves da Silva Silveira

Descrição do Trabalho

O trabalho foi realizado como parte da disciplina de Compiladores, no 6º período do curso de Engenharia de Computação do Instituto Federal Fluminense. O objetivo principal do projeto foi desenvolver um compilador utilizando a linguagem de programação Java e a ferramenta ANTLR4.

A proposta do compilador consistiu em criar uma linguagem capaz de gerar código HTML a partir da descrição de cartas do jogo Yu-Gi-Oh! fornecida pelo usuário.

Para atingir esse objetivo, foram aplicados conceitos e técnicas aprendidos ao longo da disciplina de Compiladores, tais como análise léxica, análise sintática e geração de código. A ferramenta ANTLR4 foi escolhida devido à sua capacidade de facilitar a implementação desses processos.

No processo de desenvolvimento, foram definidas regras gramaticais utilizando a sintaxe do ANTLR4 para descrever a estrutura e o formato das cartas do Yu-Gi-Oh!. Em seguida, foram implementados os analisadores léxicos e sintáticos, responsáveis por identificar e validar a sintaxe correta das descrições das cartas fornecidas pelo usuário.

Uma vez que as descrições das cartas são corretamente processadas e validadas, o compilador gera o código HTML correspondente a cada carta, respeitando as especificações de formatação e estilos definidos para a exibição das informações da carta.

O trabalho foi uma oportunidade para aplicar os conhecimentos teóricos adquiridos na disciplina de Compiladores em um projeto prático e relevante. Além disso, permitiu explorar as capacidades da linguagem Java e da ferramenta ANTLR4 na implementação de um compilador funcional.

No final, o resultado obtido foi um compilador eficiente e robusto, capaz de receber descrições de cartas Yu-Gi-Oh! e gerar o código HTML correspondente, possibilitando a visualização das informações das cartas em um formato adequado para exibição em um navegador web.

IMPORTANTE!

A versão do java utilizada na construção do projeto é:

• java version "20.0.1" 2023-04-18 Java(TM) SE Runtime Environment (build 20.0.1+9-29)

Sobre a linguagem

A linguagem desenvolvida é bem simples, é uma linguagem de descrição, não é possível realizaar operações matemátcas, nem comparações, ou outras operações lógicas. A ideia é que o usuário apenas descreva as especificações de uma carta de Yu-Gi-Oh! e a partiri disso, a carta seja gerada como saída em um arquivo HTML. Um exemplo de como a línguagem foi construída pode ser encontrado aqui -> Clique aqui. Casso o link anterior não tenha te levado para o lugar certo, tente esse: Parser.g4

Sobre cartas do jogo Yu-Gi-Oh!

Exemplo de uma carta de monstro

Existem alguns monstros especiais, como os monstros XYZ, que possuem rank no lugar do nível, mas é apenas uma mudança visual e gramatical.

Exemplo de uma carta de magia/armadilha

Uma carta de magia/armadilha é semelhante a uma carta de monstro, porém não possui nível, nem tipo, nem pontos de ataque ou defesa. Além disso seu atributo é fixo, e não varia como o de um monstro.

Exemplo da linguagem

Como dito anteriormente a linguagem é uma linguagem de definição, mas mesmo assim não está isenta de regras. Não se esqueça do ; no final de cada linha de comando.

Declaração de cartas

Carta de Monstro

• CARTA-MONSTRO: TIPO-DO-MONSTRO(SEMPR EEM LETRAS MAIÚSCULAS);

  NOME: "Nome do monstro" (sempre entre aspas duplas);

  LEVEL: (um número inteiro maior do que 0 e menor ou igual a 12);

  ATRIBUTO: ATRIBUTO DO MONSTRO (UM DOS CINCO ATRIBUTOS POSSÍVEIS, SEMPRE ME MAIÚSCULO);

  TIPO: DRAGÃO (UM DOS MUITOS TIPOS POSSÍVEIS, SEMPRE EM MAIÚSUCULO);

  ATAQUE: 3000 (Um número inteiro maior ou igual a 0 e menor ou igual a 999999);

  DEFESA: 2500 (Um número inteiro maior ou igual a 0 e menor ou igual a 999999);

  DESCRICAO: "Descrição da carta" (sempre entre aspas duplas);

  IMAGEM: "imagem.jpg" (uma única palavra, seguida de .jpg|.png, sempre entre aspas duplas);

Carta mágica/aramdilha

• CARTA-MAGICA: MAGIA-NORMAL;

  NOME: "Espadas da Luz Reveladora";

  DESCRICAO: "Descrição da carta";

  IMAGEM: "reveladora.jpg";

Opções de escolha

Opções para cada declaração

Opções de cartas de monstro

• CARTA-MONSTRO: MONSTRO-NORMAL| MONSTRO-EFEITO| MONSTRO-XYZ|MONSTRO-XYZ-EFEITO| MONSTRO-RITUAL|MONSTRO-RITUAL-EFEITO | MONSTRO-FUSAO|MONSTRO-FUSAO-EFEITO| MONSTRO-SINCRO|MONSTRO-SINCRO-EFEITO;

Opções de cartas mágicas

• CARTA-MAGICA: MAGIA-NORMAL| MAGIA-CONTINUA| MAGIA-EQUIPAMENTO| MAGIA-CAMPO| MAGIA-RITUAL| ARMADILHA-NORMAL|ARMADILHA-CONTINUA| ARMADILHA-RESPOSTA|MAGIA-RAPIDA;

Opções de atributos de monstros

• ATRIBUTO: TREVAS|FOGO|LUZ|VENTO|AGUA|TERRA|DIVINO;

Opções de tipos de monstros

• TIPO:AQUA| MAGO| DEMÔNIO| DINOSSAURO|NORMAL|EFEITO|DRAGÃO| FADA|BESTA|BESTA-GUERREIRA|BESTA-ALADA|BESTA-DIVINA|GUERREIRO| INSETO|MÁQUINA|PEIXE|PLANTA|PSÍQUICO|PIRO|RÉPTIL|ROCHA|SERPENTE-MARINHA| TROVÃO|WYRM|ZUMBI|DEUS-CRIADOR|CIBERSO|FUSÃO|XYZ|SINCRO|AQUA/REGULADOR| MAGO/REGULADOR|DEMÔNIO/REGULADOR | DINOSSAURO/REGULADOR |DRAGÃO/REGULADOR | FADA/REGULADOR | BESTA/REGULADOR | BESTA-GUERREIRA/REGULADOR | BESTA-ALADA/REGULADOR | GUERREIRO/REGULADOR | INSETO/REGULADOR | MÁQUINA/REGULADOR | PEIXE/REGULADOR | PLANTA/REGULADOR | PSÍQUICO/REGULADOR | PIRO/REGULADOR | RÉPTIL/REGULADOR | ROCHA/REGULADOR | SERPENTE-MARINHA/REGULADOR |TROVÃO/REGULADOR | WYRM/REGULADOR | ZUMBI/REGULADOR | CIBERSO/REGULADOR | FUSÃO/REGULADOR | XYZ/REGULADOR;

Como utilizar a linguagem

Um exemplo de código funcional pode ser encontrado ao lado, ou no aqui: Exemplo_codigo.txt. Para rodar o código baixe as pastas Yugioh e Yugioh_Parser, que estão presentes ao lado. Lembrando que a versão do Java deve ser a java version "20.0.1" 2023-04-18 Java(TM) SE Runtime Environment (build 20.0.1+9-29). Você pode baixar a versão mais recente do java aqui -> Java Download

Com as pastas baixadas no computador, siga o caminho: Yugioh_Parser/target/Yugioh_Parser-1.0-SNAPSHOT-jar-with-dependencies.jar, esse arquivo é o programa já compilado, caso queira utilize o arquivo de exemplo de código para executar a primeira vez.

Executando o programa

Abra o prompt de comandos do windows verifique a versão do Java utilizando java -version, caso seja uma versão diferente da 20.0.1, instale a versão mencionada. Após ter o java devidamente atualizado, digite no prompt de comando java -jar (diretório completo do arquivo: Yugioh_Parser-1.0-SNAPSHOT-jar-with-dependencies.jar) (diretório completo do arquivo de entrada: Exemplo_codigo.txt) (diretório completo do arquivo de saída: saida.HTML)

É importante dizer que, o arquivo saída.HTML, pode ter qualquer nome, porém, ele deve estar sempre dentro da pasta Yugioh. As imagens que serão utilizadas nas cartas devem ser salvas na pasta Yugioh/imagens.

Exemplo de comando

java -jar C:\Users\T-GAMER\Documents\NetBeansProjects\Yugioh_Parser\target\Yugioh_Parser-1.0-SNAPSHOT-jar-with-dependencies.jar C:\Users\T-GAMER\Desktop\Linguagem_yugioh.txt D:\Documentos\Aprendizado\Projetos\HTML\Yugioh\Saida.HTML

Ultimos avisos

Como já foi dito anteriormente, a linguagem é muito simples, e é descritiva, então, alguns erros podem ocorrer.

ERROS

• Caso você esqueça de uma linha de declarações, dependendo da linha, pode ser que o código execute, mas a carta não seja criada. Dependendo de qual linha você esquecer pode ser que nenhuma carta seja criada. Tabém existe o caso de todas as cartas declaradas antes do erro serem criadas e todas a partir do erro, não.

VAMOS JOGAR!

###%%####*++==---::::-::-::-::-::-:::::::---:-*##-#%%#%#*+**#%%%%%%%%--+**====-=*#*+-:...:-:-::............
***#########**+==--::::::::::::-:......:::::--+*%+-#%%%%#**#%%%%%%%%#+++**---:=**+-:...::-:::::.........:::
+*+++**######**++===--::::::-:--***+=-::.::::-+##%-=%%%%%##%%%%%%%%%+*+***-:-=++-:...::::::::::.......:::::
-=====+***#####***==+=:::::::::.:+*###**+=-:--=#%%*=+%%%+#%+*%%%%%%%=+=**+--===-:.:=::::::...:....:::::::::
-----===+++**#####**+=--=--:::::::-*#%%####*+-=*%%%+**%+--+::#+-%%%+-:=*#=-=-:::-+*-::::.....::::.:::::::::
=--:---=-===++*#####**+++-:-:.:.:::-++***####***%%%+--+=*--+--::#%%-::=+*-=-==+*#*=::::....::::::::::::::::
==-==+=----==+=+**#####+=-:::::::::::===-:..:-=*%%%#::-=-:*=-+::#%#=::-*****####+-:::::::::::::::::::::::::
*+**+++=====-:::=**++++++=---:-:::::::+#%%#+-:--=+*#:::-:--:++::#%*===*###%%%*=+=:::::::::::::-::::.:::::::
#****+++***+::::::--====+===-::::::::::+#%%%%#-=++=:.:..:::--=::%*=++#%%%%**=+*+:::::::::::::-:::::::::....
####*****+=-::::==---=*=====--::::::::--+#%%*:::=-:::::::.::++--=-=+##*==++**#+::::::::::::::::::::........
###*******+---:=+++*++##*=-::::::::::::::+##::-=-=-::::::::-=*=-:-==--==++###+::::::::-:::::::::.........::
##*******+:-=-:-#####+###*===------+===---*+::-:==+=---+==--:-=------++==*#*=:-:-:::::::::::::.::::::::::::
*********=:-=:::+####*+%#::::---=====+***++#-:--+-+*#-=++::::::--=+--+=+*+=--::-:::::::::::::::::::::::::--
*******+-=*#+:::+#####**#::-----=-----=+#%##*::==-+*#=-#++:::::::=-:---####**++==-:::::::::--:-------------
%%#%###*=+###::-+%#####+*::===+=++=-=---=*%%%--+--+==+::.-+:::::=+=----+%##*+=--::::::::::-----==--------::
#%#%#%%%=+###-:-#%%#####=:-==--++======--=+#*:+%:==-=::..-::::==+--*+----=--:::::::-:-------:-:-:::::......
+***+*++-=###**%%%%%####*=-===--+==+=======+-=%#:--...:::::::-==:=*#*+++=+=-::---::::::...::::::::-:----==-
+++++++===*###%%%%%%#####*==+===-=+====-=+*+:#%*::-::::::::::===+*+====++==-::::::---=-=+=++++****#*#######
++====+===*####%%%%%*#####+=+==---=#*+=++=+=+%%+:.=:::::::::-===++=+==+++=+==+**###%%%%%%%@@@@@@@@@@@@@@@@@
======--==+#####%%%#*######+==+===#%%%#*++*-%%%+=.==:::::::-====+++==+++-=-+=-++++++++***+*+*************#*
===-----===##############++===#%##%#%%%###*+#%%+*+##+=:::======+======-:-==++==+*+**++++*+++++++++++==+++=+
==-=-======###########*=====**#%%##%##%%##*####+###*+*++-:...+#=====+---==--::::-=====+*++***++*++*+++++++*
===========*#######*++*+===*####%%#%##%%#########%%+*#*-:::.-#+==---:::-====++=+===::....:---==+++*+++++**+
=======+===*####*++*###***#######%%##%%###########%=+*+*=::.*#====-:::::::::---=+*+*+++==--:::.....:::---=+
=======+===+##*+*#%%############%#%##%%##############****+-=#*====---:::::....:+*+-====+++**+++==--::::....
=++=++*=====+*#%%%%%####%%%######%##%%##%##########**+++*#*:...==---=--:::::-=*#*-.::---=-==++++*+*++++==-=
====++======#%%%%%%%###%#%#######%%%%%%%##########+###***#*=..:----==-==++###*#%=.......::----====++++*****
============#%%%%%%%###%%%######*+===#%%############*+*#*##+-.:-----==*##*##%*#+-:..........::----=-=+=++++
+==+==+=====#%%%%%%%%###%###*+======-=#%%############+*#=+##==++==--===##*##%**=:::............::::--======
===+========+*%%%%%%%%%#*+=---====-===+%%############**#####+:-=+++====+##*#%+=-=-:::...............::::---
==+===+=======+*#%%%%*+==-=======-=-+=+*%%#######***#########+==--=++===##*##*+==::--:::...............::::
+=+======+====+=+++====-===---=====++*#+*%###########***#+*****++**++=-:-+*#+===-:====--:::................
======+==+==+===+==========-======++*#**##%########*#####****#*=*##+-::.---=====--====-=---::::............
+====+=+=+======+++++============+*##**%###%#######++######*##*=-+=-----:=---==--==+=====-----:::.:........
+==+=++==++=+===+=====+=====+++++*####%%%#*%###%##%##*++##+####+=-==+*-=:+=--===+==++======-==---:::::.....
=+++=====+==+===+=+==========++**%#*#%%%#**%%%##%#####++##**##+:--*-+=+=====-======+++++==++=====----::::::

Vou me esconder nesse github, o Homem-Aranha não vai me achar aqui