DashFlag 2026.0.6__tar.gz

dashflag-2026.0.6/.gitignore

@@ -0,0 +1,5 @@
+.gitignore
+__pycache__*
+pyproject.toml
+.env
+dist*

dashflag-2026.0.6/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.5
+Name: DashFlag
+Version: 2026.0.6
+Summary: A Terminal Puzzle Game
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# DashFlag
+
+Terminal Based Puzzle Game.
+```
+    
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀    
+```
+## How to Installing
+
+Install from: `pip install dashflag` command.
+
+Or: `Releases` > download > `pip install <path>`.
+
+## Playing
+
+Run `DashFlag` in terminal. > `New` Game > Enter `Save Name` > Start!
+
+## Tips
+
+### Hints
+Entering `hint` in the question input will give a hint. You can request multiple times. Diffrent questions have diffrent numbers of hints.
+
+### Loading Saves
+
+Run `DashFlag` in terminal. > `Load` Game > Enter Save `Number`> Play. (Or `DashFlag load`)
+
+### Deleting Saves
+
+Run `DashFlag` in terminal. > `Load` Game > `Delete` > Enter Save `Number`> Confirm. (Or `DashFlag delete`)
+
+### Closing
+
+Games save after every level. Current level is displayed next to save number in load game. (`Exit` From most menus. `Ctrl + C` always exits, but may not shut down safely.)

dashflag-2026.0.6/README.md

@@ -0,0 +1,35 @@
+# DashFlag
+
+Terminal Based Puzzle Game.
+```
+    
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀    
+```
+## How to Installing
+
+Install from: `pip install dashflag` command.
+
+Or: `Releases` > download > `pip install <path>`.
+
+## Playing
+
+Run `DashFlag` in terminal. > `New` Game > Enter `Save Name` > Start!
+
+## Tips
+
+### Hints
+Entering `hint` in the question input will give a hint. You can request multiple times. Diffrent questions have diffrent numbers of hints.
+
+### Loading Saves
+
+Run `DashFlag` in terminal. > `Load` Game > Enter Save `Number`> Play. (Or `DashFlag load`)
+
+### Deleting Saves
+
+Run `DashFlag` in terminal. > `Load` Game > `Delete` > Enter Save `Number`> Confirm. (Or `DashFlag delete`)
+
+### Closing
+
+Games save after every level. Current level is displayed next to save number in load game. (`Exit` From most menus. `Ctrl + C` always exits, but may not shut down safely.)

dashflag-2026.0.6/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["hatchling >= 1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "DashFlag"
+version = "2026.0.6"
+description = "A Terminal Puzzle Game"
+readme = "README.md"
+requires-python = ">=3.9"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/DashFlag"]
+
+[project.scripts]
+DashFlag = "DashFlag.cli:main"

dashflag-2026.0.6/src/DashFlag/__main__.py

@@ -0,0 +1,3 @@
+from src.DashFlag.cli import main
+
+main()

dashflag-2026.0.6/src/DashFlag/cli.py

@@ -0,0 +1,4 @@
+from . import game
+
+def main():
+    game.main()

dashflag-2026.0.6/src/DashFlag/game.py

@@ -0,0 +1,349 @@
+import json
+import shutil
+import time
+import os
+import sys
+import re
+import subprocess
+from datetime import datetime
+from pathlib import Path
+First = True
+powershell_path = shutil.which("powershell.exe")
+
+SRCDir = Path(__file__).parent.resolve()
+levels = SRCDir / "levels.json"
+
+def runLevel(Title, question, answers, hints=(), setup=(), case_sensitive=False, run=False, check=None):
+    global First
+    
+    if First is False:
+        os.system('cls' if os.name == 'nt' else 'clear')
+
+        logo = r"""
+
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀ 
+            
+    """
+
+        print(f"{logo}") 
+    First = False
+    time.sleep(.5)
+    print(f"== {Title} ==")
+    print(f"{question}\n")
+
+    if setup:
+        for s in setup:
+            subprocess.run(s, shell=True, executable=powershell_path)
+            print(s)
+
+    norm = (lambda s: s.strip()) if case_sensitive else (lambda s: s.strip().lower())
+    accepted = {norm(a) for a in answers}
+    hintsUsed = 0
+
+    while True: 
+        try:
+            responce = input(">> ")
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return(False)
+
+        cmd = responce.strip().lower()
+        if cmd == "clear":
+            os.system('cls' if os.name == 'nt' else 'clear')
+            
+            logo = r"""
+            
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀ 
+                        
+            """
+            
+            print(f"{logo}") 
+            time.sleep(.5)
+            print(f"== {Title} ==")
+            print(f"{question}\n")
+            continue
+        if cmd == "help":
+            print("For a Hint, respond 'hint'.\nTo reset the question,'reset' For these keywords, 'help'\nTo Close, 'quit' or 'exit'.\n")
+            continue
+        if cmd in ("quit", "exit"):
+            print("Goodbye!")
+            time.sleep(.5)
+            return False
+        if cmd == "hint":
+            if hintsUsed < len(hints):
+                print(f"Hint {hintsUsed +1}: {hints[hintsUsed]}")
+                hintsUsed += 1
+            else:
+                print("Final hint given" if hints else "No hints available.")
+            continue   
+        if not responce.strip():
+            continue
+
+        correct = check(responce) if check else norm(responce) in accepted
+        if correct:
+            print("Correct!")
+
+            for i in range(1, 4):
+                dots = "." * (i % 4)
+
+                print(f"\rLoading{dots.ljust(3)}", end="", flush=True)
+                time.sleep(0.5)
+
+            #if run == True:
+            #    print(subprocess.run(answers, shell=True))
+
+            return True
+
+        print("Sorry, try again. \n")
+
+def run(save):
+    global First
+
+    os.system('cls' if os.name == 'nt' else 'clear')
+
+    logo = r"""
+
+
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀ 
+
+"""
+
+    print(f"{logo}") 
+    time.sleep(.5)
+    print("For a Hint, respond 'hint'.\nTo reset the question,'reset' For these keywords, 'help'\nTo Close, 'quit' or 'exit'.\n")
+
+    with open(levels, "r", encoding="utf-8") as f:
+        LEVELS = json.load(f)
+
+    currentLevel = save["level"]
+
+    if currentLevel >= len(LEVELS):
+        print("This save is compleated.")
+        return
+
+
+    for i in range(currentLevel, len(LEVELS)):
+        if not runLevel(**LEVELS[i]):
+            print("Exiting...")
+            return
+
+        save_game(save["name"], i + 1, i + 1 >= len(LEVELS))
+        
+    print("You have beat the game!")   
+
+
+def new_game():
+
+    print("== New Game ==")
+
+    try:
+        name = input("Save Name: ")
+    except (EOFError, KeyboardInterrupt):
+        print()
+        return(False)
+
+    if not name:
+        name = "Player"
+
+    if any(s["name"].lower() == name.lower() for s in get_saves()):
+        print("Save already Exists")
+        return
+
+    save = {
+        "name": name,
+        "level": 0,
+        "completed": False
+    }
+
+    save_game(name, 0)
+    run(save)
+
+
+
+
+def save_dir():
+    if os.name == "nt":
+        base = Path(os.getenv("APPDATA", Path.home()))
+    elif sys.platform == "darwin":
+        base = Path.home() / "Library" / "Application Support"
+    else:
+        base = Path(os.getenv("XDG_DATA_HOME", Path.home() / ".local" / "share"))
+
+    folder = base / "DashFlag" / "saves"
+    folder.mkdir(parents=True, exist_ok=True)
+    return folder
+
+def save_game(name, level, completed=False):
+    folder = save_dir()
+
+    filename = re.sub(r"[^a-zA-Z0-9_-]", "_", name)
+    path = folder / f"{filename}.json"
+
+    data = {
+        "name": name,
+        "level": level,
+        "completed": completed,
+        "last_played": datetime.now().isoformat(timespec="seconds")
+    }
+
+    tempPath = path.with_suffix(".tmp")
+    with open(tempPath, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=4)
+
+    tempPath.replace(path)
+
+def get_saves():
+    folder = save_dir()
+    saves = []
+
+    for path in folder.glob("*.json"):
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                data = json.load(f)
+                data["path"] = path
+                saves.append(data)
+        except (json.JSONDecodeError, OSError):
+            continue
+    return sorted(saves, key=lambda s: s.get("last_played", ""), reverse=True)
+
+def delete():
+    saves = get_saves()
+
+    print("== Delete Saves==\n")
+
+    if not saves:
+        print("No saves found.")
+        return
+    for i, save in enumerate(saves, 1):
+        status = "Completed" if save["completed"] else f"Level {save['level'] + 1}"
+        print(f"{i} | {save['name']} - {status}")
+
+    print("\n Enter save number to delete, or 'exit'.")
+
+    while True:
+        try:
+            responce = input(">> ").strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return
+        if responce == "exit":
+            return
+        if not responce.isdigit() or not 1 <= int(responce) <= len(saves):
+            print("Invalid.")
+            continue
+
+        save = saves[int(responce) - 1]
+
+        try:
+            confirm = input(
+                f"Delete save '{save['name']}'? This cannot be undone. (y/N): "
+            ).strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return
+        if confirm == "y":
+            try:
+                save["path"].unlink()
+                print(f"Save '{save['name']}' deleted.")
+            except OSError as error:
+                print(f"Failed to delete save '{save['name']}'. {error}")
+            return
+        elif confirm == "n" or confirm == "":
+            print("Deletion cancelled.")
+            return
+    
+
+def load():
+    saves = get_saves()
+
+    os.system('cls' if os.name == 'nt' else 'clear')
+    
+    logo = r"""
+
+    
+          ▀▀▀▀▀ ▀     ▀▀▀▄  ▀▀▀▀▀
+▀▀▀▀ ▀▀▀▀ ▄ ▀▀  █     ▄ ▀▀█ ▄ ▀▀█
+          █      ▀▄▄▄ ▀   ▀  ▀▄▄▀    
+
+    """
+    
+    print(f"{logo}") 
+    time.sleep(.5)
+    print("== Load Save ==\n")
+
+
+    if not saves:
+        print("No saves found.")
+
+        return None
+
+    for i, save in enumerate(saves, 1):
+        status = "Completed" if save["completed"] else f"Level {save['level'] + 1}"
+
+        print(f"{i} | {save['name']} - {status}")
+
+    print("\n Enter save number to load, 'delete' or 'exit'.")
+
+    while True:
+        try:
+            responce = input(">> ").strip().lower()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return(False)
+
+        if responce == "exit":
+            return None
+
+        if responce.isdigit() and 1<= int(responce) <= len(saves):
+            return saves[int(responce) - 1]
+
+        if responce == "delete":
+            delete()
+            return None
+        
+        print("Invalid.")
+
+def main():
+
+    command = sys.argv[1].lower() if len(sys.argv) > 1 else ""
+
+    if command:
+        if command == "load":
+            save = load()
+
+            if save:
+                run(save)
+
+        elif command == "new":
+            new_game()
+
+        elif command == "delete":
+            delete()
+
+        else:
+            print("Invalid.")
+    else:
+
+        try:
+            command = input("Ḻoad(L) or ṉew (L/n)? ")
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return(False)
+
+        if command == "l" or command == "load" or command == "":
+            save = load()
+
+            if save:
+                run(save)
+
+        elif command == "n" or command == "new":
+            new_game()
+
+        else:
+            print("Invalid.")

dashflag-2026.0.6/src/DashFlag/levels.json

@@ -0,0 +1,266 @@
+[
+    {
+        "Title": "Level 1 // A slashing start.",
+        "question": "Move down the load!",
+        "answers": ["cd ~/downloads"],
+        "hints": ["cd","squiggle!"]
+    },
+    {
+        "Title": "Level 2 // console.Log",
+        "question": "Can you mark where you are?",
+        "answers": ["pwd"],
+        "hints": ["Print it for me?", "Your directory, please."]
+    },
+    {
+        "Title": "Level 3 // Starting anew",
+        "question": "Let's make a new project.",
+        "answers": ["mkdir new"],
+        "hints": ["folder", "wordplay", "a what project?"]
+    },
+    {
+        "Title": "Level 4 // You know this.",
+        "question": "Making it is no good if we can't use it.",
+        "answers": ["cd new"],
+        "hints": ["How did we get here?", "back to basics", "the first one."]
+    },
+    {
+        "Title": "Level 5 // Making anew.",
+        "question": "Now we can use it, let's tell the world.",
+        "answers": ["echo Hello World > anew.txt","echo Hello World>anew.txt","echo \"Hello World\" > anew.txt"],
+        "hints": ["Hello to you too.", "Text is the way to go.", "it's in the title.", "anew, anew, anew..."]
+    },
+    {
+        "Title": "Level 6 // Let's get personal",
+        "question": "Name's Flag, -- Flag.",
+        "answers": ["whoami"],
+        "hints": ["r u?", "USER"]
+    },
+    {
+        "Title": "Level 7 // Directory?",
+        "question": "Installing some Minecraft mods from here?",
+        "answers": ["cd %appdata%"],
+        "hints": ["cd","percents? In this economy!"]
+    },
+    {
+        "Title": "Level 8 // Do you know the machine?",
+        "question": "How many versions can there be?",
+        "answers": ["winver","systeminfo"],
+        "hints": ["Can you win any more?", "du du du duh,"]
+    },
+    {
+        "Title": "Level 9 // Finnish this first?",
+        "question": "Should you shut the system down?",
+        "answers": ["systeminfo | find \"System Boot Time\"","systeminfo | findstr \"Boot Time\""],
+        "hints": ["Wouldn't be anything other than system info.", "Can you find Boot Time?"]
+    },
+    {
+        "Title": "Level 10 // Pong",
+        "question": "Is google responding?",
+        "answers": ["ping google.com","ping www.google.com"],
+        "hints": ["table tennis"]
+    },
+    {
+        "Title": "Level 11 // Radio Check, Radio Check.",
+        "question": "Loud And Clear, clear...",
+        "answers": ["Echo Loud and clear","Echo \"Loud and clear\""],
+        "hints": ["Did you repeat yourself?","You don't need to 10-9.","Is there an echo?"]
+    },
+    {
+        "Title": "Level 12 // I won't forget.",
+        "question": "Quick, write this down!",
+        "answers": ["notepad","notepad.exe","start notepad"],
+        "hints": ["Where would I write it?","You've already got it.","Just write down the text for your editor."]
+    },
+    {
+        "Title": "Level 13 // From sea to shining ̷s̷e̷a mountain.",
+        "question": "Is there a wiki page for this hidden star?",
+        "answers": ["PNG",".PNG"],
+        "hints": ["you shine like the star","What file does it make?","Initials?","Hey, Pap(u)a!"]
+    },
+    {
+        "Title": "Level 14 // That's a bit awkward.",
+        "question": "I won't come to your house, will Dan?",
+        "answers": ["minecon 2015"],
+        "hints": ["Very CONvincing","Full name please"]
+    },
+    {
+        "Title": "Level 15 // Odd Flag.",
+        "question": "Need to govern those mountains.",
+        "answers": ["Nepal"],
+        "hints": ["Try to climb."]
+    },
+    {
+        "Title": "Level 16 // But made in china.",
+        "question": "Talk'n bout apples pods.",
+        "answers": ["Designed in California"],
+        "hints": ["Cast it?","Relay","Upgrade"]
+    },
+    {
+        "Title": "Level 17 // Easthamlet.",
+        "question": "Have fun at R2PH+X2...",
+        "answers": ["Cape Cod National Seashore", "Salt Pond Visitor Center","Cape Cod National Seashore Salt Pond Visitor Center"],
+        "hints": ["Plus the code.","Picture it Eastham,"]
+    },
+    {
+        "Title": "Level 18 // Brewing Altitude",
+        "question": "__ runs on dunkin",
+        "answers": ["Jetblue","Jetblue runs on dunkin"],
+        "hints": ["KBOS", "Blu"]
+    },
+    {
+        "Title": "Level 19 // WhatAmI?",
+        "question": "What am I going for? (CXRC+X7 Stavelot, Belgium)",
+        "answers": ["Belgian Grand Prix","Belgian GP"],
+        "hints": ["Car go Vroom", "Formula Uno","event name"]
+    },
+    {
+        "Title": "Level 20 // Float your Goat?",
+        "question": "First draft of Cape Liberty.",
+        "answers": ["28","8.5"],
+        "hints": ["google maps/earth", "satellite coverage","10/16/25"]
+    },
+    {
+        "Title": "Level 21A // Document This",
+        "question": "Your mission, is to find the code.",
+        "answers": ["484F5720414C495645"],
+        "hints": ["When would I document it?", "Is there a new file?","10/16/25"],
+        "setup": ["cd ([Environment]::GetFolderPath('MyDocuments')); echo 484F5720414C495645 > riddle.txt"]
+    },
+    {
+        "Title": "Level 21B // Space Pirates!",
+        "question": "Where am I from?",
+        "answers": ["The Martian"],
+        "hints": ["Decode the string.", "Colors, in HEX","Book, and Film."],
+        "setup": ["cd ([Environment]::GetFolderPath('MyDocuments')); del riddle.txt"]
+        
+    },
+    {
+        "Title": "Level 22 // Gold In Space",
+        "question": "What Java is on the record?",
+        "answers": ["Kinds of Flowers","Robert Brown"],
+        "hints": ["On this Voyage we go.", "Music to my ears","NASA"]
+    },
+    {
+        "Title": "Level 23 // The next Alexandria",
+        "question": "Everything is here.",
+        "answers": ["The British Library","British Library"],
+        "hints": ["Books? Books!", "Publication and all."]
+    },
+    {
+        "Title": "Level 24 // DATETIME",
+        "question": "When does time start?",
+        "answers": ["1 January 1970","1/1/1970","January 1, 1970"],
+        "hints": ["For computers."]
+    },
+    {
+        "Title": "Level 25 // Men's 200m Breaststroke.",
+        "question": "World records in 16'",
+        "answers": ["Marco Koch"],
+        "hints": ["Not FIFA, but.", "Berlin."]
+    },
+    {
+        "Title": "Level 26 // Monaco, but for Monaco.",
+        "question": "Your name, please.",
+        "answers": ["Grand Prix de Monaco Historique", "Monaco Historic Grand Prix"],
+        "hints": ["Old and rich.", "It's been 20 years!","The real one is in 2 weeks."]
+    },
+    {
+        "Title": "Level 27 // A segue, to our...",
+        "question": "...British bag?",
+        "answers": ["British Millerain"],
+        "hints": ["___Store.com", "Bag for Commuting","A Tech Sack too."]
+    },
+    {
+        "Title": "Level 28 // Cape? Third time's the charm.",
+        "question": "A bend in the reeds.",
+        "answers": ["Cape Canaveral", "Canaveral", "Cape Kennedy", "Cape Canaveral Space Force Station"],
+        "hints": ["Explosions, for science!","That's a lot of Gs","What goes up must come down."]
+    },
+    {
+        "Title": "Level 29 // Round and Round we go.",
+        "question": "To Infinity and, Park.",
+        "answers": ["Apple Park", "1 Infinite Loop"],
+        "hints": ["Rainbows and sunshine.","'Hair Force One clear for land.'","iBuilding"]
+    },
+    {
+        "Title": "Level 30 // Not gold.",
+        "question": "-gate, a scandal.",
+        "answers": ["Golden Gate Bridge"],
+        "hints": ["Title + Question"]
+    },
+    {
+        "Title": "Level 31A // Flashing Green.",
+        "question": "Where do the Green Lights Flash?",
+        "answers": ["BC", "British Columbia", "Vancouver"],
+        "hints": ["Expensive Rent next to Coal"]
+    },
+    {
+        "Title": "Level 31B // #Van",
+        "question": "9 o'clock shots.",
+        "answers": ["Stanley Park"],
+        "hints": ["marvel camio", "cannon"]
+    },
+    {
+        "Title": "Level 32 // Island Income",
+        "question": "Expensive top level tourist store.",
+        "answers": [".ai", "ai", "Anguilla"],
+        "hints": ["not in my domain", "caribean", "centre de données"]
+    },
+    {
+        "Title": "Level 33 // Not one Game",
+        "question": "Select player one?",
+        "answers": ["Roblox"],
+        "hints": ["What game has games?", "The OG"]
+    },
+    {
+        "Title": "Level 34 // Break the Curse?",
+        "question": "Modify it.",
+        "answers": ["CurseForge"],
+        "hints": ["Forge it.", "overwolf"]
+    },
+    {
+        "Title": "Level 35 // looks Like,",
+        "question": "google it.",
+        "answers": [
+            "Invoke-WebRequest \"https://google.com\"",
+            "Invoke-WebRequest https://google.com",
+            "Invoke-WebRequest -Uri https://google.com",
+            "Invoke-WebRequest -Uri \"https://google.com\"",
+            "iwr https://google.com",
+            "iwr google.com",
+            "curl https://google.com",
+            "curl google.com"
+        ],
+        "hints": ["google.com", "powershell"]
+    },
+    {
+        "Title": "Level 36 // Point Away",
+        "question": "Point where?",
+        "answers": ["Nemo", "Point Nemo"],
+        "hints": ["Not a Fish"]
+    },
+    {
+        "Title": "Level 37 // Mathematics",
+        "question": "144, 233, 610",
+        "answers": ["377"],
+        "hints": ["Don't fib.","skipping"]
+    },
+    {
+        "Title": "Level 38 // Decode, Please.",
+        "question": "Show your work.",
+        "answers": ["certutil -decode", "certutil"],
+        "hints": ["Just the work.", "base of 4 carrot 3"]
+    },
+    {
+        "Title": "Level 39 // Rescue Mission",
+        "question": "Five",
+        "answers": ["BRM5","BRM","Blackhawk Rescue Mission 5","Blackhawk Rescue Mission"],
+        "hints": ["Doesn't look like roblox", "helicopter", "platinum"]
+    },
+    {
+        "Title": "Level 40 // Set Sail",
+        "question": "cjNneDJ1eA==",
+        "answers": ["sydney opera house", "the sydney opera house", "bennelong point"],
+        "hints": ["geohash, is it?"]
+    }
+]