Card ++

Introduction

A card game is any game that uses cards as the primary device with which the game is played. Card games have always been a big part of human history. As such, we want to give people a tool to be able to continue this tradition via computer programs.

As part of our Structure and Properties of Programming Languages course we have been tasked with the creation of a new programming language which, in our case, would result in being able to create card games in a short amount of time, with little experience in programming required.

We want to create a language that would facilitate the development of any card game imaginable. For the scope of this project we will limit Card++ to only be able to use the fifty-two casino suite cards.

Tutorial

Below is a video verison of the Card++ tutorial. Make sure that you turn on the Closed Captions.

Tools Used

PLY - PLY (Python Lex-Yacc) is an implementation of lex and yacc parsing tools for Python, developed by David Beazley. This tool is used to establish and interpret our language's grammar.

Installation

1. Download Card++ from our GitHub repository at _https://github.com/Eliemer/Card-plus-plus .
2. Make sure that you have Python 3 (3.6) installed in your machine with the PLY (3.10) library.
3. Run the Card++.py file on your IDE or terminal.
4. Start using Card++.

Using Card++

Card++ allows you to create your card game using the fifty-two casino suit cards.

• Cards:

A simple declaration to start creating the cards in the game.

Card cardname = ("value","suit");

For example, if we want to declare the three of diamonds, we would type the following in Card++:

Card Diamonds3 = ("3", "Diamonds");

A valid card declaration receives a valid value and suit as parameters, though we can declare the name however we want.

• Fields:

After you declare the desired number of cards, a field can be created to represent the different types of fields in a card game. The following is the syntax used to declare a field:

Field fieldname [Card 0, Card 1, Card 2, ... , Card N-1];

We could declare a Field composed of only the three of diamonds:

Field Deck [Diamonds3];

It is also valid to declare an empty field, for example an empty hand would be declared as follows:

Field Hand [];

After the hands and fields are declared, it is valid to operate on them using Card++'s functions.

Some functions are:

• Shuffle(Deck);

Shuffles a field to randomize their order in any given field, whether it's a deck, a player's hand or any other pile.

• flip (Diamonds3);

Toggles visibility of a card in any given field, to allow certain cards to be able to be viewed by a player or not, such as another player's hand, a card being face-down on the playing field, or simply making the deck invisible to players.

• Draw(Deck);

Draws the top card from the given Field and adds it to the player's hand.

Developers

This project was developed by Eliemer Velez, Ariel Torres and Jonathan Irizarry under the supervision of Dr. Wilson Rivera at the University of Puerto Rico - Mayaguez Campus.

A final report for this project may be found in the project, or by following this link: https://github.com/Eliemer/Card-plus-plus/blob/master/Card%2B%2B%20Final%20Report.pdf