pyjack-blackjack 2__tar.gz

pyjack_blackjack-2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ConsciousBone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyjack_blackjack-2/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: pyjack-blackjack
+Version: 2
+Summary: A simple blackjack game, but in a single Python file... How revolutionary!
+Author-email: ConsciousBone <eplant@consciousb.one>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ConsciousBone/PyJack
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PyJack</h1>
+![Hackatime Badge](https://hackatime-badge.hackclub.com/U0998E0AFFD/PyJack)  
+It's blackjack, but in a single Python file.  
+Created for Hack Club's Stardance!  
+It runs almost anywhere you can run Python (I've not tested this claim but there's nothing really stopping it!), and requires such low system specs that I think the toaster sitting in your kitchen could comfortably run it.  
+
+# Demos
+## Screenshots
+<img src="/screenshots/1.png" width=384> <img src="/screenshots/2.png" width=384>  
+<img src="/screenshots/3.png" width=384> <img src="/screenshots/4.png" width=384>
+## Video
+[YouTube video (unlisted)](https://youtu.be/rOiauafCkaA)
+
+# How to play
+1. Download Python from [this page](https://www.python.org/downloads/) if you don't already have it installed.
+2. Download the latest release of PyJack from [this page](https://github.com/ConsciousBone/PyJack/releases/).
+3. Run the downloaded `pyjack.py` file. All the required JSON files will be automatically created in a new `.pyjack_data` directory inside your home folder!
+4. Play the game! Only the keyboard is required for this. You navigate around the menus using the number keys, and actually control the game using H and S to hit or stand. Simple!
+
+# Why?
+Why not?
+
+# No but seriously, why?
+Blackjack is a pretty good time-waster game, and for those times where you've got nothing to do, why not play some blackjack against a computer? It was also a fun challenge to test my (admittedly kind of lacking) Python skills.
+
+# Any future plans for this?
+Yes! In the future I'd like to implement a GUI of some sorts and a money system, however due to my great time management skills, I've left most of this to the last day of Stardance, therefore leaving me with no time to actually implement such features...  
+If you want to have a go at implementing these yourself, why not fork this repo and see if you can add some stuff into this simple game?
+
+# Tools I used
+- Google
+- ChatGPT (to fix some small bugs, help out with understanding blackjack's rules, and help out with understanding how to publish this on PyPI)
+- Wikipedia (to copy-paste the fancy Unicode symbols used for the cards)
+- VS Code (to write the damn thing)
+
+# Something's broken?
+Make a GitHub issue on [this page](https://github.com/ConsciousBone/PyJack/issues), or DM me on Slack and I'll investigate the issue as soon as possible!

pyjack_blackjack-2/README.md

@@ -0,0 +1,37 @@
+# PyJack</h1>
+![Hackatime Badge](https://hackatime-badge.hackclub.com/U0998E0AFFD/PyJack)  
+It's blackjack, but in a single Python file.  
+Created for Hack Club's Stardance!  
+It runs almost anywhere you can run Python (I've not tested this claim but there's nothing really stopping it!), and requires such low system specs that I think the toaster sitting in your kitchen could comfortably run it.  
+
+# Demos
+## Screenshots
+<img src="/screenshots/1.png" width=384> <img src="/screenshots/2.png" width=384>  
+<img src="/screenshots/3.png" width=384> <img src="/screenshots/4.png" width=384>
+## Video
+[YouTube video (unlisted)](https://youtu.be/rOiauafCkaA)
+
+# How to play
+1. Download Python from [this page](https://www.python.org/downloads/) if you don't already have it installed.
+2. Download the latest release of PyJack from [this page](https://github.com/ConsciousBone/PyJack/releases/).
+3. Run the downloaded `pyjack.py` file. All the required JSON files will be automatically created in a new `.pyjack_data` directory inside your home folder!
+4. Play the game! Only the keyboard is required for this. You navigate around the menus using the number keys, and actually control the game using H and S to hit or stand. Simple!
+
+# Why?
+Why not?
+
+# No but seriously, why?
+Blackjack is a pretty good time-waster game, and for those times where you've got nothing to do, why not play some blackjack against a computer? It was also a fun challenge to test my (admittedly kind of lacking) Python skills.
+
+# Any future plans for this?
+Yes! In the future I'd like to implement a GUI of some sorts and a money system, however due to my great time management skills, I've left most of this to the last day of Stardance, therefore leaving me with no time to actually implement such features...  
+If you want to have a go at implementing these yourself, why not fork this repo and see if you can add some stuff into this simple game?
+
+# Tools I used
+- Google
+- ChatGPT (to fix some small bugs, help out with understanding blackjack's rules, and help out with understanding how to publish this on PyPI)
+- Wikipedia (to copy-paste the fancy Unicode symbols used for the cards)
+- VS Code (to write the damn thing)
+
+# Something's broken?
+Make a GitHub issue on [this page](https://github.com/ConsciousBone/PyJack/issues), or DM me on Slack and I'll investigate the issue as soon as possible!

pyjack_blackjack-2/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyjack-blackjack"
+version = "2"
+authors = [
+  { name="ConsciousBone", email="eplant@consciousb.one" },
+]
+description = "A simple blackjack game, but in a single Python file... How revolutionary!"
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/ConsciousBone/PyJack"
+
+[project.scripts]
+pyjack = "pyjack:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+py-modules = ["pyjack"]

pyjack_blackjack-2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyjack_blackjack-2/src/pyjack.py

@@ -0,0 +1,350 @@
+# ░░░░░░░░░░░░░░░░░░░░░░░░░
+# ░█▀█░█░█░▀▀█░█▀█░█▀▀░█░█░
+# ░█▀▀░░█░░░░█░█▀█░█░░░█▀▄░
+# ░▀░░░░▀░░▀▀░░▀░▀░▀▀▀░▀░▀░
+# ░░░░░░░░░░░░░░░░░░░░░░░░░
+# PyJack - Blackjack but in a single Python file!
+# Created by @consciousbone for Hack Club's Stardance
+# ASCII art from https://www.asciiart.eu/text-to-ascii-art
+
+# MARK: Imports
+import os
+import random
+import time
+import json
+
+# MARK: General constants
+PYJACK_VERSION = 2
+DATA_DIR = os.path.join(os.path.expanduser("~"), ".pyjack_data")
+
+PYJACK_STATS_FILENAME = os.path.join(DATA_DIR, "stats.json")
+PYJACK_CONFIG_FILENAME = os.path.join(DATA_DIR, "config.json")
+
+# MARK: General variables
+menu_error_header = ""
+
+# MARK: General subroutines
+def clear():
+    os.system('cls' if os.name == 'nt' else 'clear') # clear terminal
+
+def print_logo(page_name):
+    config = read_config()
+    use_ascii_logo = config.get('show_ascii_art', 1)
+
+    if use_ascii_logo == 1: # show ascii art
+        print(f'''
+░░░░░░░░░░░░░░░░░░░░░░░░░
+░█▀█░█░█░▀▀█░█▀█░█▀▀░█░█░
+░█▀▀░░█░░░░█░█▀█░█░░░█▀▄░
+░▀░░░░▀░░▀▀░░▀░▀░▀▀▀░▀░▀░
+░░░░░░░░░░░░░░░░░░░░░░░░░
+PyJack (v{PYJACK_VERSION})
+{page_name}
+
+─────────────────────────
+    ''')
+    else: # don't show ascii art
+        print(f"\nPyJack (v{PYJACK_VERSION})\n{page_name}\n\n─────────────────────────\n")
+
+# MARK: Data subroutines/functions
+# Partially stolen from another thing I wrote, https://github.com/R002441/HackTrack
+def initialise_files():
+    os.makedirs(DATA_DIR, exist_ok=True)
+
+    if not os.path.exists(PYJACK_STATS_FILENAME): # write default stats file if it doesn't exist
+        default_stats = {
+            "games_won": 0,
+            "games_lost": 0,
+            "games_drew": 0
+        }
+
+        with open(PYJACK_STATS_FILENAME, "w", encoding="utf-8") as file:
+            json.dump(default_stats, file, indent=4)
+
+    if not os.path.exists(PYJACK_CONFIG_FILENAME): # write default config file if it doesn't exist
+            default_config = {
+                "show_ascii_art": 1,
+                "dealer_hits_delay": 1
+            }
+    
+            with open(PYJACK_CONFIG_FILENAME, "w", encoding="utf-8") as file:
+                json.dump(default_config, file, indent=4)
+
+def read_stats():
+    if not os.path.exists(PYJACK_STATS_FILENAME):
+        return {}
+    with open(PYJACK_STATS_FILENAME, "r") as file:
+        return json.load(file) # read json file
+
+def write_stats(stats):
+    with open(PYJACK_STATS_FILENAME, "w") as file:
+        json.dump(stats, file, indent=2) # write back into json
+
+def read_config():
+    if not os.path.exists(PYJACK_CONFIG_FILENAME):
+        return {}
+    with open(PYJACK_CONFIG_FILENAME, "r") as file:
+        return json.load(file) # read json file
+
+def write_config(config):
+    with open(PYJACK_CONFIG_FILENAME, "w") as file:
+        json.dump(config, file, indent=2) # write back into json
+
+# MARK: Menu subroutines
+def menu_header(page_name):
+    global menu_error_header # let this subroutine use that var
+
+    clear() # very clean very fancy very wow
+    print_logo(page_name)
+
+    if menu_error_header != "": # theres an error which needs showing, do it!
+        print(f"{menu_error_header}\n")
+        menu_error_header = "" # clear it to ensure it doesn't keep showing
+
+
+def main_menu():
+    while True:
+        global menu_error_header # let this subroutine use that var
+        menu_header("Main menu")
+        print('''\
+1) Play
+2) Stats
+3) Config
+4) Quit
+        ''')
+
+        selected_menu_option = input("Select an option.\n> ") # get input
+        if selected_menu_option == "1": # play
+            while True: # loop
+                play_blackjack()
+
+                while True: # prevents the else case from starting another game
+                    play_again = input("Play again (Y/n)?\n> ")
+                    if play_again.lower() == "y": # play again
+                        clear() # clear screen so terminal isnt cluttered with previous game
+                        break # play again
+                    elif play_again.lower() == "n": # don't play again, back to menu
+                        clear()
+                        break
+                    elif play_again.strip() == "": # user inputted nothing, default to yes
+                        clear()
+                        break
+                    else: # user inputted something else entirely
+                        print("Invalid option.")
+
+                if play_again.lower() == "n": # don't play again, back to menu
+                        break # exit the play again loop
+        elif selected_menu_option == "2": # stats
+            stats_menu()
+        elif selected_menu_option == "3": # config
+            config_menu()
+        elif selected_menu_option == "4": # quit
+            print("Thanks for playing!")
+            break
+        else:
+            menu_error_header = "Invalid option."
+
+def stats_menu():
+    while True:
+        global menu_error_header
+        stats = read_stats()
+
+        menu_header("Stats")
+
+        print(f"Games won: {stats['games_won']}")
+        print(f"Games lost: {stats['games_lost']}")
+        print(f"Games drew: {stats['games_drew']}")
+
+        print() # blank line for seperation
+        print('''\
+1) Back
+            ''')
+
+        selected_menu_option = input("Select an option.\n> ")
+        if selected_menu_option == "1":
+            return
+        else:
+            menu_error_header = "Invalid option."
+
+def config_menu():
+    while True:
+        global menu_error_header
+        config = read_config()
+
+        menu_header("Config")
+
+        print("Current config:") # there's probably a much better way to do this, but this is easy :)
+        if config.get('show_ascii_art', 1) == 1:
+            print("Show ASCII art: Yes")
+        elif config.get('show_ascii_art', 1) == 0:
+            print("Show ASCII art: No")
+        if config.get('dealer_hits_delay', 1) == 1:
+            print("Dealer has delay when hitting: Yes")
+        elif config.get('dealer_hits_delay', 1) == 0:
+            print("Dealer has delay when hitting: No")
+
+        print() # blank line for seperation 
+        print('''\
+1) Toggle "Show ASCII art"
+2) Toggle "Dealer has delay when hitting"
+3) Back
+            ''')
+
+        selected_menu_option = input("Select an option.\n> ")
+        if selected_menu_option == "1":
+            if config.get('show_ascii_art', 1) == 1:
+                config['show_ascii_art'] = 0
+                write_config(config)
+                menu_error_header = "Toggled \"Show ASCII art\"."
+
+            elif config.get('show_ascii_art', 1) == 0:
+                config['show_ascii_art'] = 1
+                write_config(config)
+                menu_error_header = "Toggled \"Show ASCII art\"."
+
+        elif selected_menu_option == "2":
+            if config.get('dealer_hits_delay', 1) == 1:
+                config['dealer_hits_delay'] = 0
+                write_config(config)
+                menu_error_header = "Toggled \"Dealer has delay when hitting\"."
+
+            elif config.get('dealer_hits_delay', 1) == 0:
+                config['dealer_hits_delay'] = 1
+                write_config(config)
+                menu_error_header = "Toggled \"Dealer has delay when hitting\"."
+
+        elif selected_menu_option == "3":
+            return
+        
+        else:
+            menu_error_header = "Invalid option."
+
+
+# MARK: Blackjack constants
+SUITS = ["♠", "♥", "♦", "♣"] # ooh fancy unicode thanks to https://en.wikipedia.org/wiki/Playing_cards_in_Unicode
+RANKS = ["A", "2", "3", "4", "5", "6", "7", "8", "9", "10", "J", "Q", "K"]
+
+# MARK: Blackjack variables
+deck = []
+
+# MARK: Blackjack subroutines/functions
+def build_deck():
+    deck.clear() # make sure deck doesn't end up massive
+    for suit in SUITS:
+        for rank in RANKS:
+            deck.append((rank, suit))
+    random.shuffle(deck)
+
+def hand_value(hand):
+    value = 0
+    aces = 0
+
+    for rank, suit in hand:
+        if rank in ["J", "Q", "K"]: # handle the cards that aren't numbers, aces come later
+            value += 10
+        elif rank == "A": # now handle aces part 1; default to 11, but will move to 1 later if it would cause a bust
+            value += 11
+            aces += 1 # keep track of number of aces for later
+        else:
+            value += int(rank) # ez
+
+    while value > 21 and aces > 0: # handle aces part 2; turn aces one by one from 11 to 1
+        value -= 10
+        aces -= 1
+
+    return value # finished counting!
+
+def show_hand(name, hand, hide_first_card=False):
+    if hide_first_card: # hide the first card, used with dealer
+        cards = ["??"] + [f"{rank}{suit}" for rank, suit in hand[1:]] # skip first card since it's hidden
+        print(f"{name}: {' '.join(cards)}") # make sure cards are formatted nicely
+    else:
+        cards = [f"{rank}{suit}" for rank, suit in hand]
+        print(f"{name}: {' '.join(cards)} ({hand_value(hand)})") # also show hand value for player
+
+
+def play_blackjack(): # the main event 0.0
+    stats = read_stats()
+    config = read_config()
+
+    build_deck() # get a deck
+    menu_header("Play")
+
+    player = [deck.pop(), deck.pop()] # give player 2 cards
+    dealer = [deck.pop(), deck.pop()] # give dealer 2 cards
+
+    while True: # player's turn!
+        show_hand("Dealer", dealer, hide_first_card=True) # show dealer's hand, hiding first card
+        show_hand("Player", player) # show player's hand, ofc not hiding your own cards :/
+
+        player_value = hand_value(player)
+        if player_value == 21: # player is at blackjack, end
+            if len(player) == 2:
+                print("Blackjack!\n")
+            else:
+                print("21!\n")
+            break
+        if player_value > 21: # player is bust, end
+            stats['games_lost'] = stats['games_lost'] + 1
+            write_stats(stats)
+            print("Bust, you lose!\n")
+            return
+
+        print("") # blank line for visual seperation
+        choice = input("(H)it or (S)tand?\n> ")
+        if choice.lower() == "h": # hit; resiliant to PEBCAK errors (google it :D)
+            player.append(deck.pop()) # give player another card
+        elif choice.lower() == "s": # stand; also resiliant to PEBCAK errors
+            break # exit while loop, dealer's turn!
+        else:
+            print("Invalid option.")
+
+        print("") # another blank line for seperation
+
+    # dealer's turn!
+    print("\nDealer's turn!\n")
+
+    show_hand("Dealer", dealer) # show dealer's hand, *not* hiding first card
+    show_hand("Player", player) # show player's hand, ofc not hiding your own cards :/
+
+    while hand_value(dealer) < 17: # dealer must stand on 17
+        if config.get('dealer_hits_delay', 1) == 1: # does config allow for a delay
+            time.sleep(random.uniform(0.5, 1)) # wait for random amount of time between 0.5s and 1s
+
+        print("") # blank line for seperation
+        print("Dealer hits!")
+        dealer.append(deck.pop()) # give dealer another card
+
+        print("")
+        show_hand("Dealer", dealer) # show dealer's hand, *not* hiding first card
+        show_hand("Player", player) # show player's hand, ofc not hiding your own cards :/
+
+    dealer_value = hand_value(dealer)
+    player_value = hand_value(player)
+
+    if dealer_value > 21: # dealer is bust :D
+        stats['games_won'] = stats['games_won'] + 1
+        write_stats(stats)
+        print("\nDealer bust!")
+    elif dealer_value > player_value: # dealer wins
+        stats['games_lost'] = stats['games_lost'] + 1
+        write_stats(stats)
+        print("\nDealer wins!")
+    elif dealer_value < player_value: # player wins
+        stats['games_won'] = stats['games_won'] + 1
+        write_stats(stats)
+        print("\nYou win!")
+    else: # draw
+        stats['games_drew'] = stats['games_drew'] + 1
+        write_stats(stats)
+        print("\nIt\'s a draw!")
+
+    print("")
+
+# MARK: Run the damn thing
+def main():
+    initialise_files() # create data files if they don't exist
+    main_menu() # run main menu
+
+if __name__ == "__main__":
+    main()

pyjack_blackjack-2/src/pyjack_blackjack.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: pyjack-blackjack
+Version: 2
+Summary: A simple blackjack game, but in a single Python file... How revolutionary!
+Author-email: ConsciousBone <eplant@consciousb.one>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ConsciousBone/PyJack
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PyJack</h1>
+![Hackatime Badge](https://hackatime-badge.hackclub.com/U0998E0AFFD/PyJack)  
+It's blackjack, but in a single Python file.  
+Created for Hack Club's Stardance!  
+It runs almost anywhere you can run Python (I've not tested this claim but there's nothing really stopping it!), and requires such low system specs that I think the toaster sitting in your kitchen could comfortably run it.  
+
+# Demos
+## Screenshots
+<img src="/screenshots/1.png" width=384> <img src="/screenshots/2.png" width=384>  
+<img src="/screenshots/3.png" width=384> <img src="/screenshots/4.png" width=384>
+## Video
+[YouTube video (unlisted)](https://youtu.be/rOiauafCkaA)
+
+# How to play
+1. Download Python from [this page](https://www.python.org/downloads/) if you don't already have it installed.
+2. Download the latest release of PyJack from [this page](https://github.com/ConsciousBone/PyJack/releases/).
+3. Run the downloaded `pyjack.py` file. All the required JSON files will be automatically created in a new `.pyjack_data` directory inside your home folder!
+4. Play the game! Only the keyboard is required for this. You navigate around the menus using the number keys, and actually control the game using H and S to hit or stand. Simple!
+
+# Why?
+Why not?
+
+# No but seriously, why?
+Blackjack is a pretty good time-waster game, and for those times where you've got nothing to do, why not play some blackjack against a computer? It was also a fun challenge to test my (admittedly kind of lacking) Python skills.
+
+# Any future plans for this?
+Yes! In the future I'd like to implement a GUI of some sorts and a money system, however due to my great time management skills, I've left most of this to the last day of Stardance, therefore leaving me with no time to actually implement such features...  
+If you want to have a go at implementing these yourself, why not fork this repo and see if you can add some stuff into this simple game?
+
+# Tools I used
+- Google
+- ChatGPT (to fix some small bugs, help out with understanding blackjack's rules, and help out with understanding how to publish this on PyPI)
+- Wikipedia (to copy-paste the fancy Unicode symbols used for the cards)
+- VS Code (to write the damn thing)
+
+# Something's broken?
+Make a GitHub issue on [this page](https://github.com/ConsciousBone/PyJack/issues), or DM me on Slack and I'll investigate the issue as soon as possible!

pyjack_blackjack-2/src/pyjack_blackjack.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/pyjack.py
+src/pyjack_blackjack.egg-info/PKG-INFO
+src/pyjack_blackjack.egg-info/SOURCES.txt
+src/pyjack_blackjack.egg-info/dependency_links.txt
+src/pyjack_blackjack.egg-info/entry_points.txt
+src/pyjack_blackjack.egg-info/top_level.txt

pyjack_blackjack-2/src/pyjack_blackjack.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyjack_blackjack-2/src/pyjack_blackjack.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyjack = pyjack:main

pyjack_blackjack-2/src/pyjack_blackjack.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyjack