APICartas
=========

API de cartas de baralho

VISÃO GERAL DO PROJETO

A biblioteca de manipulação de baralho, por padrão o tradicional de 52 cartas 
sem curingas, que  deve fornecer uma representação das cartas e funções/métodos
para manipulação das cartas. São esperadas as funções de  embaralhar, cortar em 
duas partes (em uma determinada posição e juntando em um único baralho no final),
retirar uma carta do inicio e do final, passar uma carta do inicio para o final 
(sem mostrar que carta é), e a criação de um monte de descarte do qual podemos 
ver qualquer carta sem removê-la (no monte de compra uma carta só pode ser vista 
se for removida dele).


CONSTRUÇÃO DA BIBLIOTECA

Foi usado para a construção da biblioteca o construtor Apache Ant
<http://ant.apache.org/>. É necessário que ele esteja instalado para que seja
construído.
Para construir a biblioteca, acesse o terminal/command, vá até a pasta que possui
o arquivo build.xml, e use o comando "ant". Após concluída a construção, será criada
uma pasta dist, que vai conter o .jar da biblioteca. O site do javadoc ficará na
pasta dist/javadoc/index.html.


LOCALIZAÇÃO DOS ARQUIVOS

código-fonte: ${repositorio}/APICartas/APICartas/src/
build.xml do ant: ${repositorio}/APICartas/APICartas/build.xml
jar da biblioteca: ${repositorio}/APICartas/APICartas/dist/APICartas.jar
site do javadoc: ${repositorio}/APICartas/APICartas/dist/javadoc/index.html


USO DA BIBLIOTECA

O uso da biblioteca foi separado em um projeto diferente, disponível neste link
<https://github.com/mateusdalforno/TesteBaralho>. Lá encontra-se as instruções
de como rodar os testes.