Richard-Mensah/GHANA-Asante-Twi-Translation-CLI

This command-line interface (CLI) program allows users to translate common English phrases into Asante Twi, a widely spoken dialect in Ghana. It serves as a simple translation tool and also allows users to add and delete translations, with changes saved persistently using a .json file ## 📘 GHANA Asante Twi Translation CLI 🗣️ ### Developer: Richard Mensah ### Course: ICE-4101: Introduction to Programming ### 📘 Overview This command-line interface (CLI) program allows users to translate common English phrases into Asante Twi, a widely spoken dialect in Ghana. It serves as a simple translation tool and also allows users to add and delete translations, with changes saved persistently using a .json file. *This project is ideal for learning basic CLI structure, dictionary operations, file persistence using JSON, and user interaction in Python.* **The application uses only Python’s standard library, specifically**: - **json** : For reading and writing translations to a file - **os** : For file existence checking and path handling - **sys** : For system-level operations ### 🚀 Features - 🔁 Translate English phrases to Asante Twi. - ➕ Add new phrase-translation pairs. - ❌ Delete existing translations. - 💾 Persistent data storage using a JSON file (twi_translations.json). - 🧠 Intelligent input handling with user-friendly messages and error checking. 🛠️ Setup Instructions 1. ✅ Requirements Before running the program, make sure you have Python installed (version 3.6 or above). - 🛠️ Setup Instructions ``` python --version ``` ``` pip install -r requirements.txt ``` ## 🚀 Running the Program To run the CLI Translator App: ```python run main.py ``` ### 2. 📦 File Structure ### Choose an option from the menu: === Asante Twi Translation CLI === 1. Translate an English phrase to Asante Twi 2. Add a new translation 3. Delete a translation 4. Exit ==================================== ### 📂 Data Persistence All translations are stored in a JSON file named twi_translations.json. This ensures your additions and deletions are saved across sessions. - If the file does not exist on first run, it will be initialized with a default dictionary, including phrases like: { "hello": "maakye", "goodbye": "nante yie", "thank you": "meda wo ase", "how are you" …