Camicia

Instruções

Neste exercício, vais simular um jogo muito semelhante ao clássico jogo de cartas Camicia. O teu programa vai receber a configuração inicial dos baralhos de dois jogadores e tem de simular o jogo até este terminar (ou detetar que nunca vai terminar).

Regras

• O baralho é dividido entre dois jogadores. As cartas do jogador leem-se da esquerda para a direita, sendo a carta mais à esquerda o topo do baralho.
• Uma ronda consiste em ambos os jogadores jogarem pelo menos uma carta.
• Os jogadores colocam alternadamente a carta do topo do seu baralho numa pilha central.
• Se a carta for uma carta numérica (2-10), a jogada passa simplesmente para o outro jogador.
• Se a carta for uma carta de pagamento, é preciso pagar uma penalização:
  • J → o adversário tem de pagar 1 carta
  • Q → o adversário tem de pagar 2 cartas
  • K → o adversário tem de pagar 3 cartas
  • A → o adversário tem de pagar 4 cartas
• Se o jogador que está a pagar uma penalização revelar outra carta de pagamento, esse jogador deixa de pagar a penalização. O outro jogador tem então de pagar uma penalização com base na nova carta de pagamento.
• Se a penalização for paga na totalidade sem interrupção, o jogador que colocou a última carta de pagamento recolhe a pilha central e coloca-a no fundo do seu baralho. Esse jogador começa então a ronda seguinte.
• Se um jogador ficar sem cartas e não conseguir jogar uma carta (quer durante o pagamento de uma penalização, quer quando é a sua vez), o outro jogador recolhe a pilha central.
• O momento em que um jogador recolhe as cartas da pilha central chama-se uma vaza.
• Se, depois de uma vaza, um jogador tiver todas as cartas na sua posse, o jogo termina.
• O jogo entra num ciclo assim que os baralhos forem idênticos ao que eram anteriormente durante o jogo, sem contar as cartas numéricas!

Exemplos

Um pequeno exemplo de uma partida que termina.

status: "finished", cards: 13, tricks: 1

Este é um pequeno exemplo de uma partida que entra em ciclo.

O início da ronda 4 é igual ao início da ronda 2. Lembra-te: o valor das cartas numéricas não importa.

status: "loop", cards: 8, tricks: 3

A tua tarefa

• Com base nos dados de entrada, simula o jogo seguindo as regras acima.
• Determina as seguintes informações sobre o jogo:
  • Status: "finished" ou "loop"
  • Cards: número total de cartas jogadas ao longo do jogo
  • Tricks: número de vezes que a pilha central foi recolhida

Prós e contras de from_quote

A função Card.from_quote analisa uma string e transforma-a num Card. Isto permite escrever código como este:

card : Card
card = "Q"

Este código chama implicitamente Card.from_quote("Q") em tempo de compilação. Executar código em tempo de compilação com esta abordagem (ou com outros métodos descritos abaixo) pode acelerar o programa, uma vez que não é preciso tratar a análise e a validação dos dados em tempo de execução. Além disso, garante que os dados inválidos (como um formato de data incorreto) são rejeitados em tempo de compilação, em vez de em tempo de execução, o que torna a tua aplicação mais robusta. Por último, torna o código agradável e legível. Por exemplo, este é um dos testes deste exercício:

result = simulate_game({
    player_a: ["2", "A"],
    player_b: ["3", "4", "5", "6", "K"],
})

No entanto, quem lê este código pode assumir que a função simulate_game recebe um registo com dois List(Str), quando na verdade é um registo com dois List(Card). Isto pode dar origem a confusão e erros. Por isso, podes preferir o formato um pouco mais longo mas mais explícito: "Q".Card, que também chama from_quote em tempo de compilação.

Nos teus próprios programas, podes preferir usar from_str:

Card := { ... }.{
    from_str : Str -> Try(Card, [InvalidCard])
    from_str = |card_str| ...
}

Também podes chamar from_str (ou qualquer outra função pura) em tempo de compilação, assim:

Ok(card) = Card.from_str("Q")

Nota: colocar esta definição ao nível superior faz com que seja executada em tempo de compilação (uma vez que a função é pura e o seu parâmetro de entrada é conhecido em tempo de compilação). Dentro de uma função, podes usar from_str em tempo de execução.

Dicas

---

Fonte

Beggar-My-Neighbour