keyglow 0.1.0__py3-none-any.whl

keyglow/data.py

@@ -0,0 +1,73 @@
+import string
+
+
+KEY_STATS = {
+    key: 0 for key in string.ascii_uppercase
+}
+
+
+KEY_STATS.update({
+
+    # Numbers
+    "0": 0,
+    "1": 0,
+    "2": 0,
+    "3": 0,
+    "4": 0,
+    "5": 0,
+    "6": 0,
+    "7": 0,
+    "8": 0,
+    "9": 0,
+
+
+    # Symbols
+    "`": 0,
+    "-": 0,
+    "=": 0,
+    "[": 0,
+    "]": 0,
+    "\\": 0,
+    ";": 0,
+    "'": 0,
+    ",": 0,
+    ".": 0,
+    "/": 0,
+
+
+    # Special keys
+    "SPACE": 0,
+    "ENTER": 0,
+    "BACKSPACE": 0,
+    "TAB": 0,
+    "CAPSLOCK": 0,
+
+
+    # Modifiers
+    "SHIFT": 0,
+    "CTRL": 0,
+    "ALT": 0,
+    "SYSTEM": 0,
+
+
+    # Navigation
+    "UP": 0,
+    "DOWN": 0,
+    "LEFT": 0,
+    "RIGHT": 0,
+
+
+    # Function keys
+    "F1": 0,
+    "F2": 0,
+    "F3": 0,
+    "F4": 0,
+    "F5": 0,
+    "F6": 0,
+    "F7": 0,
+    "F8": 0,
+    "F9": 0,
+    "F10": 0,
+    "F11": 0,
+    "F12": 0,
+})

keyglow/export.py

@@ -0,0 +1,161 @@
+import json
+import csv
+
+from pathlib import Path
+from datetime import datetime
+
+from keyglow.storage import load_data
+
+
+EXPORT_DIR = Path.home() / "KeyGlow" / "Exports"
+
+def ensure_export_dir():
+    EXPORT_DIR.mkdir(parents=True, exist_ok=True)
+
+def create_export_path(extension):
+    """
+    Creates export folder and filename with timestamp.
+    """
+
+    EXPORT_DIR.mkdir(
+        parents=True,
+        exist_ok=True
+    )
+
+    timestamp = datetime.now().strftime(
+        "%Y-%m-%d_%H-%M-%S"
+    )
+
+    return EXPORT_DIR / (
+        f"keyglow_export_{timestamp}.{extension}"
+    )
+
+
+
+def export_json():
+    ensure_export_dir()
+    data = load_data()
+
+    file = create_export_path("json")
+
+
+    with file.open(
+        "w",
+        encoding="UTF-8"
+    ) as f:
+
+        json.dump(
+            data,
+            f,
+            indent=4,
+            ensure_ascii=False
+        )
+
+
+    return file
+
+
+
+def export_csv():
+    ensure_export_dir()
+    data = load_data()
+
+    file = create_export_path("csv")
+
+
+    with file.open(
+        "w",
+        newline="",
+        encoding="UTF-8"
+    ) as f:
+
+        writer = csv.writer(f)
+
+        writer.writerow(
+            [
+                "Key",
+                "Presses"
+            ]
+        )
+
+
+        for key, presses in data.items():
+
+            writer.writerow(
+                [
+                    key,
+                    presses
+                ]
+            )
+
+
+    return file
+
+
+
+def export_txt():
+    ensure_export_dir()
+    data = load_data()
+
+    file = create_export_path("txt")
+
+
+    total = sum(data.values())
+
+
+    sorted_data = sorted(
+        data.items(),
+        key=lambda x: x[1],
+        reverse=True
+    )
+
+
+    with file.open(
+        "w",
+        encoding="UTF-8"
+    ) as f:
+
+        f.write(
+            "==============================\n"
+        )
+
+        f.write(
+            "KeyGlow Export\n"
+        )
+
+        f.write(
+            "==============================\n\n"
+        )
+
+
+        f.write(
+            f"Total key presses:\n{total}\n\n"
+        )
+
+
+        f.write(
+            "Keyboard statistics:\n\n"
+        )
+
+
+        for key, presses in sorted_data:
+
+            f.write(
+                f"{key:<12}{presses}\n"
+            )
+
+
+        f.write(
+            "\nPrivacy:\n\n"
+        )
+
+        f.write(
+            "KeyGlow stores only key frequency counters.\n"
+        )
+
+        f.write(
+            "No typed text, passwords or key sequences are recorded.\n"
+        )
+
+
+    return file

keyglow/jokes.py

@@ -0,0 +1,34 @@
+import random
+
+KEYBOARD_JOKES = [
+    "The Career Change: I got fired from my job at the keyboard factory today. I just couldn't keep the space clean!",
+    "The Breakup: I tried dating a keyboard, but we had to break up... she just wasn't my type.",
+    "The Lost Keys: Why did the keyboard lose its job after the car accident? It lost all control. (trust me, this one is funny)",
+    "The Punctuation Problem: I took all the punctuation marks off the judge's keyboard. I expect a long sentence.",
+    "Why did the keyboard break up with the mouse? Because it felt like it was being controlled.",
+    "Why don't keyboards ever get tired? Because they always have a lot of keys.",
+    "I wanted to tell my keyboard a joke... but it didn't have the right key for humor.",
+    "My keyboard and I have a great relationship. We are always on the same page.",
+    "Why was the keyboard so good at music? Because it had the right keys.",
+    "The keyboard went to therapy. It had too many unresolved issues.",
+    "My keyboard told me a secret, but I couldn't understand it. It was written in uppercase. (Hella funny, just laugh gng)",
+    "Why did the programmer throw away his keyboard? It had too many bugs.",
+    "The spacebar walked into a bar. It was a very empty conversation.",
+    "Why did the enter key get promoted? Because it always knew how to make an entrance.",
+    "The CTRL key tried to relax but it couldn't let go of control.",
+    "The shift key is underrated. It always changes things.",
+    "The backspace key is the most forgiving key. It always gives you another chance. (Hella funny innit? (not really))",
+    "The keyboard was feeling depressed It just needed a little space",
+    "The keyboard looked at KeyGlow statistics and said: 'Finally someone appreciates how much I suffer every day' (yes, I am glazing my own tool)",
+    "The keyboard went on vacation. It needed some time away from all the pressure.",
+    "The spacebar is the most important key. Without it, everyone would just be typinglikethisandnobodywantsthat",
+    "What's Elon Musk's favourite keyboard shortcut? Ctrl + Space + X",
+    "Why do keyboards never sleep? Because they have two shifts.",
+    "What do you call a keyboard with one letter constantly pressed? O-Pressed.",
+    "Why do cats like to step on computer keyboards? because jfaeiogjea;g;elg,aiognaoghaoheioqj0jf0i1fap`D1j2orjew",
+    "How do you type the word 'Royalty' on the keyboard? You start with the higher R key.",
+    "My wife told me that she would smash my face into the keyboard if I didn't stop being misogynist... And that's when I let her know that I'm the Man of the House, the King of the Castle, the Lord of the Mancjkkf no jskslskf d j.lo alsjdj djdjslai48 err is shwks9ri3jekdo 3irbdjdibsks."
+]
+
+def get_joke():
+    return random.choice(KEYBOARD_JOKES)

keyglow/keyboard.py

@@ -0,0 +1,64 @@
+KEYBOARD_LAYOUT = [
+    # FUNCTIONS
+    [
+        "ESC",
+        "F1", "F2", "F3", "F4",
+        "F5", "F6", "F7", "F8",
+        "F9", "F10", "F11", "F12"
+    ],
+
+
+    # NUMBERS
+    [
+        "`",
+        "1", "2", "3", "4", "5",
+        "6", "7", "8", "9", "0",
+        "-", "=",
+        "BACKSPACE"
+    ],
+
+
+    # Q ROW
+    [
+        "TAB",
+        "Q", "W", "E", "R", "T",
+        "Y", "U", "I", "O", "P",
+        "[", "]"
+    ],
+
+
+    # A ROW
+    [
+        "CAPSLOCK",
+        "A", "S", "D", "F", "G",
+        "H", "J", "K", "L",
+        ";", "'", "\\",
+        "ENTER"
+    ],
+
+
+    # Z ROW
+    [
+        "SHIFT",
+        "Z", "X", "C", "V", "B",
+        "N", "M",
+        ",", ".", "/",
+        "SHIFT"
+    ],
+
+
+    # BOTTOM ROW
+    [
+        "CTRL",
+        "ALT",
+        "SYSTEM",
+        "SPACE",
+        "SYSTEM",
+        "ALT",
+        "CTRL",
+        "LEFT",
+        "UP",
+        "DOWN",
+        "RIGHT"
+    ]
+]

keyglow/logo.py

@@ -0,0 +1,16 @@
+from rich import print
+
+LOGO = r"""
+██╗  ██╗███████╗██╗   ██╗ ██████╗ ██╗      ██████╗ ██╗    ██╗
+██║ ██╔╝██╔════╝╚██╗ ██╔╝██╔════╝ ██║     ██╔═══██╗██║    ██║
+█████╔╝ █████╗   ╚████╔╝ ██║  ███╗██║     ██║   ██║██║ █╗ ██║
+██╔═██╗ ██╔══╝    ╚██╔╝  ██║   ██║██║     ██║   ██║██║███╗██║
+██║  ██╗███████╗   ██║   ╚██████╔╝███████╗╚██████╔╝╚███╔███╔╝
+╚═╝  ╚═╝╚══════╝   ╚═╝    ╚═════╝ ╚══════╝╚═════╝  ╚══╝╚══╝
+"""
+
+def show_logo():
+    print(f"[bold cyan]{LOGO}[/bold cyan]")
+    print("[dim]Privacy-first keyboard usage heatmap and statistics.[/dim]")
+    print("[dim]Version 0.1.0[/dim]\n")
+