{"id":24792735,"url":"https://github.com/misaghmomenib/task-tracker-cli-python","last_synced_at":"2025-03-24T16:11:15.979Z","repository":{"id":263670559,"uuid":"891118425","full_name":"MisaghMomeniB/Task-Tracker-CLI-Python","owner":"MisaghMomeniB","description":"A Command-line Interface (Cli) Task Tracker Built With Python. Efficiently Manage and Organize Tasks, Set Deadlines, and Track Progress—all From the Terminal for a Streamlined Productivity Experience.","archived":false,"fork":false,"pushed_at":"2024-12-24T07:28:06.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T20:54:51.138Z","etag":null,"topics":["cli","git","python","task-tracker"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MisaghMomeniB.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-19T18:59:01.000Z","updated_at":"2025-01-01T04:40:24.000Z","dependencies_parsed_at":"2024-11-19T20:26:27.799Z","dependency_job_id":"a4d7cbd6-c18f-47df-80c0-c28fa02c23d1","html_url":"https://github.com/MisaghMomeniB/Task-Tracker-CLI-Python","commit_stats":null,"previous_names":["misaghmomenib/task-tracker-cli-python"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MisaghMomeniB","download_url":"https://codeload.github.com/MisaghMomeniB/Task-Tracker-CLI-Python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245304873,"owners_count":20593626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","git","python","task-tracker"],"created_at":"2025-01-29T20:54:45.223Z","updated_at":"2025-03-24T16:11:15.953Z","avatar_url":"https://github.com/MisaghMomeniB.png","language":"Python","readme":"# 📝 Task Tracker\n\nWelcome to the **Task Tracker**! 🚀 This simple Python program allows you to manage your daily tasks with ease. It lets you add tasks, mark them as completed, and save them for future use. The tasks are stored in a `tasks.json` file, which ensures your data is persistent even after the program ends. ✅\n\n### 🚀 Features:\n- 🆕 **Add new tasks**: You can easily add tasks to your to-do list.\n- ✔️ **Mark tasks as completed**: Track your progress by marking tasks as complete.\n- 💾 **Persistent data storage**: All tasks are saved in a JSON file (`tasks.json`).\n- 📑 **View tasks**: Quickly view your tasks and their current completion status.\n\n### 💡 How It Works:\nThe Task Tracker program is a command-line application that interacts with the user through a simple text-based interface. Here’s how the flow works:\n\n1. **Load Tasks**: When you start the application, it loads existing tasks from `tasks.json`. If the file doesn’t exist or is corrupted, the program will start with an empty task list.\n2. **Add a Task**: You can add a new task by providing a title. The new task will be added with the status \"not completed\".\n3. **Mark Task as Complete**: You can choose a task to mark as completed. It will show a ✅ (check mark) beside the task.\n4. **Save Tasks**: After adding or completing tasks, the task list is saved to the JSON file so that it persists when you reopen the program.\n\n### 🎥 Screenshots:\n*(Add any screenshots or GIFs demonstrating the application in action if you'd like!)*\n\n---\n\n### 🛠️ Requirements:\nTo run the Task Tracker, make sure you have:\n- Python 3.x installed\n- Basic knowledge of how to run Python scripts from the command line\n\n### 📥 How to Run:\n1. **Clone or Download** this repository to your local machine.\n2. **Navigate** to the project directory in your terminal.\n3. **Run** the script with:\n   ```bash\n   python task_tracker.py\n   ```\n\n---\n\n### 📜 Code Explanation:\n\nHere’s a breakdown of how the program works:\n\n1. **Loading and Saving Tasks**:\n   ```python\n   def load_tasks():\n       # Loads tasks from 'tasks.json' if it exists\n   def save_tasks(tasks):\n       # Saves tasks to 'tasks.json' in a readable format\n   ```\n\n2. **Displaying Tasks**:\n   ```python\n   def display_tasks(tasks):\n       # Shows a list of tasks with their current completion status (✔️ or ❌)\n   ```\n\n3. **Adding Tasks**:\n   ```python\n   def add_task(tasks):\n       # Prompts the user to add a new task with a title and adds it to the list\n   ```\n\n4. **Marking Tasks as Complete**:\n   ```python\n   def mark_task_complete(tasks):\n       # Lets the user choose a task to mark as complete (✔️)\n   ```\n\n5. **The Main Menu**:\n   ```python\n   def main():\n       # Provides a text-based menu to the user to manage tasks\n   ```\n\n---\n\n### 🔧 How to Contribute:\n- Feel free to fork this repository, make improvements, or add new features like task priority, due dates, or more advanced task management options.\n- Open an issue if you find any bugs or if you'd like to request new features.\n\n---\n\n### 🙏 Special Thanks:\nThanks for checking out this project! I hope it helps you stay organized and boost your productivity! 🏆\n\n---\n\n### 👋 Stay Connected:\nFeel free to reach out with feedback or suggestions! 😊\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python/lists"}