/black_jack

Console based Blackjack project for learning Python w/ tests - Week 1

Primary LanguagePython

Black Jack Card Game

By Trent Dietzel

Table of Contents

About

This is a simple Blackjack game implemented in Python. The game allows players to play Blackjack against a computer-controlled dealer.

Features

  • Player vs. Dealer: Play Blackjack against the computer-controlled dealer.
  • Hit or Stand: Choose whether to hit (draw another card) or stand (keep the current hand) during your turn.
  • Winning Conditions: Win the game by having a higher score than the dealer without exceeding 21 points.
  • Currency: Users can win or lose currency while playing

Technologies Used

  • Python: The core programming language used to implement the game logic.
  • unittest Module: Used for writing and running automated tests to ensure the correctness of the game's functionality.
  • Random Module: Utilized for shuffling the deck of cards and dealing random cards to players.
  • Terminal/Console: The game interface is presented in the terminal/console, allowing players to interact via text input.

Installation

Follow these steps to set up the project locally:

  1. Open Git BASH Download Link
  2. Clone the repository to your local machine: 
    git clone https://github.com/tdietzel/black_jack
  3. Open the project directory: 
    cd *black_jack*
  4. Open in a code editor like Visual Studio Code.
  5. In the command line, run the command python app.py to compile and execute the console application. Since this is a console application, you'll interact with it through text commands in your terminal.

Contributing

I welcome contributions to improve the project. If you'd like to contribute, please follow these guidelines:

  1. Fork the project repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and test thoroughly.
  4. Commit your changes with a descriptive commit message.
  5. Push your branch to your forked repository.
  6. Create a pull request to the main repository.

Known Bugs

  • N/A

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions, suggestions, or inquiries, please contact Trent Dietzel at dietzelbiz@outlook.com.