typing-cli 0.1.0__tar.gz

typing_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lecoffre
+
+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.

typing_cli-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: typing-cli
+Version: 0.1.0
+Summary: A beautiful CLI typing test to practice your typing speed
+Author: lecoffre
+License: MIT
+Project-URL: Homepage, https://github.com/lecoffre/typing-cli
+Project-URL: Repository, https://github.com/lecoffre/typing-cli
+Project-URL: Issues, https://github.com/lecoffre/typing-cli/issues
+Keywords: typing,test,cli,wpm,speed,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.50.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pyfiglet>=1.0.0
+Requires-Dist: platformdirs>=4.0.0
+Dynamic: license-file
+
+# ⌨️ typing-cli
+
+A beautiful and fast CLI typing test — right from your terminal.
+
+Practice your typing speed with real-time WPM tracking, accuracy stats, animated pixel-art F1 car, multiple languages, and color themes.
+
+[![PyPI version](https://img.shields.io/pypi/v/typing-cli.svg)](https://pypi.org/project/typing-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+```
+  __               _                        ___ 
+ / /___  ______  (_)___  ____ _        ____/ (_)
+/ __/ / / / __ \/ / __ \/ __ `/  ____ / __/ / / 
+/ /_/ /_/ / /_/ / / / / / /_/ /  /___// /_/ / /  
+\__/\__, / .___/_/_/ /_/\__, /        \__/_/_/   
+   /____/_/            /____/                     
+```
+
+## 🚀 Installation
+
+```bash
+pip install typing-cli
+```
+
+That's it. Works on **Windows**, **macOS**, and **Linux**.
+
+### From source
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+```
+
+## ▶️ Usage
+
+```bash
+typing-cli
+```
+
+The app launches in your terminal. Start typing!
+
+## 🔄 Update
+
+```bash
+pip install --upgrade typing-cli
+```
+
+## ⌨️ Keyboard Shortcuts
+
+| Shortcut       | Action                     |
+|----------------|----------------------------|
+| `Tab`          | Restart test               |
+| `Escape`       | Back / Quit                |
+| `Ctrl+T`       | Change theme               |
+| `Ctrl+L`       | Change language            |
+| `Ctrl+M`       | Switch mode (words/code)   |
+| `Ctrl+H`       | View score history         |
+| `Ctrl++/-`     | Zoom in/out                |
+| `Ctrl+Q`       | Quit                       |
+
+## 🌍 Languages
+
+Built-in:
+- 🇬🇧 English (200 most common words)
+- 🇫🇷 French (200 most common words)
+
+## 🎨 Themes
+
+- **Midnight** — deep dark blues (default)
+- **Forest** — earthy greens
+- **Sunset** — warm amber tones
+- **Ocean** — cool cyan palette
+- **Mono** — minimal grayscale
+
+## 📊 Features
+
+- Real-time WPM & accuracy tracking
+- Per-character coloring (correct / incorrect / cursor)
+- Animated pixel-art F1 car reflecting your speed
+- Gamification: streak, combo, milestones, rank system
+- Code typing mode
+- Score history with date, WPM, accuracy
+- Multiple languages & themes
+- Splash screen with ASCII art
+- Clean, extensible architecture
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+
+# Run directly
+python -m typingtest
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues and pull requests.
+
+1. Fork the repo
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit (`git commit -m 'Add amazing feature'`)
+4. Push (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+[MIT](LICENSE)

typing_cli-0.1.0/README.md

@@ -0,0 +1,112 @@
+# ⌨️ typing-cli
+
+A beautiful and fast CLI typing test — right from your terminal.
+
+Practice your typing speed with real-time WPM tracking, accuracy stats, animated pixel-art F1 car, multiple languages, and color themes.
+
+[![PyPI version](https://img.shields.io/pypi/v/typing-cli.svg)](https://pypi.org/project/typing-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+```
+  __               _                        ___ 
+ / /___  ______  (_)___  ____ _        ____/ (_)
+/ __/ / / / __ \/ / __ \/ __ `/  ____ / __/ / / 
+/ /_/ /_/ / /_/ / / / / / /_/ /  /___// /_/ / /  
+\__/\__, / .___/_/_/ /_/\__, /        \__/_/_/   
+   /____/_/            /____/                     
+```
+
+## 🚀 Installation
+
+```bash
+pip install typing-cli
+```
+
+That's it. Works on **Windows**, **macOS**, and **Linux**.
+
+### From source
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+```
+
+## ▶️ Usage
+
+```bash
+typing-cli
+```
+
+The app launches in your terminal. Start typing!
+
+## 🔄 Update
+
+```bash
+pip install --upgrade typing-cli
+```
+
+## ⌨️ Keyboard Shortcuts
+
+| Shortcut       | Action                     |
+|----------------|----------------------------|
+| `Tab`          | Restart test               |
+| `Escape`       | Back / Quit                |
+| `Ctrl+T`       | Change theme               |
+| `Ctrl+L`       | Change language            |
+| `Ctrl+M`       | Switch mode (words/code)   |
+| `Ctrl+H`       | View score history         |
+| `Ctrl++/-`     | Zoom in/out                |
+| `Ctrl+Q`       | Quit                       |
+
+## 🌍 Languages
+
+Built-in:
+- 🇬🇧 English (200 most common words)
+- 🇫🇷 French (200 most common words)
+
+## 🎨 Themes
+
+- **Midnight** — deep dark blues (default)
+- **Forest** — earthy greens
+- **Sunset** — warm amber tones
+- **Ocean** — cool cyan palette
+- **Mono** — minimal grayscale
+
+## 📊 Features
+
+- Real-time WPM & accuracy tracking
+- Per-character coloring (correct / incorrect / cursor)
+- Animated pixel-art F1 car reflecting your speed
+- Gamification: streak, combo, milestones, rank system
+- Code typing mode
+- Score history with date, WPM, accuracy
+- Multiple languages & themes
+- Splash screen with ASCII art
+- Clean, extensible architecture
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+
+# Run directly
+python -m typingtest
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues and pull requests.
+
+1. Fork the repo
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit (`git commit -m 'Add amazing feature'`)
+4. Push (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+[MIT](LICENSE)

typing_cli-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "typing-cli"
+version = "0.1.0"
+description = "A beautiful CLI typing test to practice your typing speed"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "lecoffre"},
+]
+keywords = ["typing", "test", "cli", "wpm", "speed", "terminal"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Games/Entertainment",
+]
+dependencies = [
+    "textual>=0.50.0",
+    "click>=8.1.0",
+    "pyfiglet>=1.0.0",
+    "platformdirs>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/lecoffre/typing-cli"
+Repository = "https://github.com/lecoffre/typing-cli"
+Issues = "https://github.com/lecoffre/typing-cli/issues"
+
+[project.scripts]
+typing-cli = "typingtest.__main__:main"
+typing-test = "typingtest.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+typingtest = ["data/languages/*.json", "ui/css/*.tcss"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100

typing_cli-0.1.0/setup.cfg

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

typing_cli-0.1.0/src/typing_cli.egg-info/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: typing-cli
+Version: 0.1.0
+Summary: A beautiful CLI typing test to practice your typing speed
+Author: lecoffre
+License: MIT
+Project-URL: Homepage, https://github.com/lecoffre/typing-cli
+Project-URL: Repository, https://github.com/lecoffre/typing-cli
+Project-URL: Issues, https://github.com/lecoffre/typing-cli/issues
+Keywords: typing,test,cli,wpm,speed,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.50.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pyfiglet>=1.0.0
+Requires-Dist: platformdirs>=4.0.0
+Dynamic: license-file
+
+# ⌨️ typing-cli
+
+A beautiful and fast CLI typing test — right from your terminal.
+
+Practice your typing speed with real-time WPM tracking, accuracy stats, animated pixel-art F1 car, multiple languages, and color themes.
+
+[![PyPI version](https://img.shields.io/pypi/v/typing-cli.svg)](https://pypi.org/project/typing-cli/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+```
+  __               _                        ___ 
+ / /___  ______  (_)___  ____ _        ____/ (_)
+/ __/ / / / __ \/ / __ \/ __ `/  ____ / __/ / / 
+/ /_/ /_/ / /_/ / / / / / /_/ /  /___// /_/ / /  
+\__/\__, / .___/_/_/ /_/\__, /        \__/_/_/   
+   /____/_/            /____/                     
+```
+
+## 🚀 Installation
+
+```bash
+pip install typing-cli
+```
+
+That's it. Works on **Windows**, **macOS**, and **Linux**.
+
+### From source
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+```
+
+## ▶️ Usage
+
+```bash
+typing-cli
+```
+
+The app launches in your terminal. Start typing!
+
+## 🔄 Update
+
+```bash
+pip install --upgrade typing-cli
+```
+
+## ⌨️ Keyboard Shortcuts
+
+| Shortcut       | Action                     |
+|----------------|----------------------------|
+| `Tab`          | Restart test               |
+| `Escape`       | Back / Quit                |
+| `Ctrl+T`       | Change theme               |
+| `Ctrl+L`       | Change language            |
+| `Ctrl+M`       | Switch mode (words/code)   |
+| `Ctrl+H`       | View score history         |
+| `Ctrl++/-`     | Zoom in/out                |
+| `Ctrl+Q`       | Quit                       |
+
+## 🌍 Languages
+
+Built-in:
+- 🇬🇧 English (200 most common words)
+- 🇫🇷 French (200 most common words)
+
+## 🎨 Themes
+
+- **Midnight** — deep dark blues (default)
+- **Forest** — earthy greens
+- **Sunset** — warm amber tones
+- **Ocean** — cool cyan palette
+- **Mono** — minimal grayscale
+
+## 📊 Features
+
+- Real-time WPM & accuracy tracking
+- Per-character coloring (correct / incorrect / cursor)
+- Animated pixel-art F1 car reflecting your speed
+- Gamification: streak, combo, milestones, rank system
+- Code typing mode
+- Score history with date, WPM, accuracy
+- Multiple languages & themes
+- Splash screen with ASCII art
+- Clean, extensible architecture
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/lecoffre/typing-cli.git
+cd typing-cli
+pip install -e .
+
+# Run directly
+python -m typingtest
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues and pull requests.
+
+1. Fork the repo
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit (`git commit -m 'Add amazing feature'`)
+4. Push (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+[MIT](LICENSE)

typing_cli-0.1.0/src/typing_cli.egg-info/SOURCES.txt

@@ -0,0 +1,29 @@
+LICENSE
+README.md
+pyproject.toml
+src/typing_cli.egg-info/PKG-INFO
+src/typing_cli.egg-info/SOURCES.txt
+src/typing_cli.egg-info/dependency_links.txt
+src/typing_cli.egg-info/entry_points.txt
+src/typing_cli.egg-info/requires.txt
+src/typing_cli.egg-info/top_level.txt
+src/typingtest/__init__.py
+src/typingtest/__main__.py
+src/typingtest/core/__init__.py
+src/typingtest/core/config.py
+src/typingtest/core/generator.py
+src/typingtest/core/stats.py
+src/typingtest/core/tracker.py
+src/typingtest/data/languages/english.json
+src/typingtest/data/languages/french.json
+src/typingtest/ui/__init__.py
+src/typingtest/ui/app.py
+src/typingtest/ui/screens/__init__.py
+src/typingtest/ui/screens/history.py
+src/typingtest/ui/screens/result.py
+src/typingtest/ui/screens/splash.py
+src/typingtest/ui/screens/typing_screen.py
+src/typingtest/ui/widgets/__init__.py
+src/typingtest/ui/widgets/character.py
+src/typingtest/ui/widgets/stats_bar.py
+src/typingtest/ui/widgets/typing_area.py

typing_cli-0.1.0/src/typing_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

typing_cli-0.1.0/src/typing_cli.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+typing-cli = typingtest.__main__:main
+typing-test = typingtest.__main__:main

typing_cli-0.1.0/src/typing_cli.egg-info/requires.txt

@@ -0,0 +1,4 @@
+textual>=0.50.0
+click>=8.1.0
+pyfiglet>=1.0.0
+platformdirs>=4.0.0

typing_cli-0.1.0/src/typing_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+typingtest

typing_cli-0.1.0/src/typingtest/__init__.py

@@ -0,0 +1,3 @@
+"""typing-cli — A beautiful CLI typing test."""
+
+__version__ = "0.1.0"

typing_cli-0.1.0/src/typingtest/__main__.py

@@ -0,0 +1,21 @@
+"""CLI entry point — `typing-cli` command."""
+
+from __future__ import annotations
+
+import click
+
+from typingtest import __version__
+
+
+@click.command(context_settings={"help_option_names": ["-h", "--help"]})
+@click.version_option(__version__, "-v", "--version", prog_name="typing-cli")
+def main() -> None:
+    """⌨️  typing-cli — practice your typing speed in the terminal."""
+    from typingtest.ui.app import TypingTestApp
+
+    app = TypingTestApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

typing_cli-0.1.0/src/typingtest/core/config.py

@@ -0,0 +1,118 @@
+"""Configuration management — persist user settings and score history."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+from platformdirs import user_config_dir, user_data_dir
+
+APP_NAME = "typing-test"
+
+CONFIG_DIR = Path(user_config_dir(APP_NAME, ensure_exists=True))
+DATA_DIR = Path(user_data_dir(APP_NAME, ensure_exists=True))
+
+CONFIG_FILE = CONFIG_DIR / "config.json"
+HISTORY_FILE = DATA_DIR / "history.json"
+
+DEFAULTS: dict[str, Any] = {
+    "language": "english",
+    "theme": "midnight",
+    "word_count": 30,
+    "zoom": 1,
+    "mode": "words",          # "words" or "code"
+    "code_language": "python", # python, typescript, javascript, rust, go
+}
+
+THEMES = ["midnight", "forest", "sunset", "ocean", "mono"]
+LANGUAGES = ["english", "french"]
+MODES = ["words", "code"]
+ZOOM_LEVELS = [0, 1, 2, 3]  # 0=compact, 1=normal, 2=large, 3=extra-large
+
+
+# ── Zoom presets ──────────────────────────────────────────────────────
+# Each level defines container width, padding, and letter spacing.
+
+ZOOM_PRESETS: dict[int, dict[str, Any]] = {
+    0: {"width": 90, "padding_x": 1, "padding_y": 0, "line_height": 0, "letter_spacing": 0, "label": "compact"},
+    1: {"width": 76, "padding_x": 2, "padding_y": 1, "line_height": 0, "letter_spacing": 0, "label": "normal"},
+    2: {"width": 60, "padding_x": 3, "padding_y": 1, "line_height": 1, "letter_spacing": 1, "label": "large"},
+    3: {"width": 46, "padding_x": 4, "padding_y": 2, "line_height": 1, "letter_spacing": 2, "label": "x-large"},
+}
+
+
+def _load_json(path: Path) -> Any:
+    if path.exists():
+        return json.loads(path.read_text(encoding="utf-8"))
+    return None
+
+
+def _save_json(path: Path, data: Any) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data, indent=2, ensure_ascii=False), encoding="utf-8")
+
+
+# ── Settings ──────────────────────────────────────────────────────────
+
+
+def load_config() -> dict[str, Any]:
+    """Load user settings, falling back to defaults."""
+    data = _load_json(CONFIG_FILE)
+    if data is None:
+        data = dict(DEFAULTS)
+        _save_json(CONFIG_FILE, data)
+    # back-fill any new keys added in future versions
+    for key, val in DEFAULTS.items():
+        data.setdefault(key, val)
+    return data
+
+
+def save_config(cfg: dict[str, Any]) -> None:
+    _save_json(CONFIG_FILE, cfg)
+
+
+def cycle_option(cfg: dict[str, Any], key: str, options: list[str]) -> str:
+    """Cycle a config value to the next option and persist."""
+    current = cfg.get(key, options[0])
+    idx = options.index(current) if current in options else -1
+    new_val = options[(idx + 1) % len(options)]
+    cfg[key] = new_val
+    save_config(cfg)
+    return new_val
+
+
+def zoom_in(cfg: dict[str, Any]) -> int:
+    """Increase zoom level (capped at max)."""
+    current = cfg.get("zoom", 1)
+    new_val = min(current + 1, max(ZOOM_LEVELS))
+    cfg["zoom"] = new_val
+    save_config(cfg)
+    return new_val
+
+
+def zoom_out(cfg: dict[str, Any]) -> int:
+    """Decrease zoom level (capped at min)."""
+    current = cfg.get("zoom", 1)
+    new_val = max(current - 1, min(ZOOM_LEVELS))
+    cfg["zoom"] = new_val
+    save_config(cfg)
+    return new_val
+
+
+# ── Score History ─────────────────────────────────────────────────────
+
+
+def load_history() -> list[dict[str, Any]]:
+    data = _load_json(HISTORY_FILE)
+    return data if isinstance(data, list) else []
+
+
+def save_score(entry: dict[str, Any]) -> None:
+    """Append a score entry to history."""
+    history = load_history()
+    history.append(entry)
+    # keep last 100 scores
+    if len(history) > 100:
+        history = history[-100:]
+    _save_json(HISTORY_FILE, history)