A minimalistic and user-friendly task management application built with Python
Project description
TaskMan CLI
📝 Description
TaskMan CLI is a powerful and user-friendly task management application built with Python. It offers a seamless command-line interface for efficiently managing your daily tasks, helping you boost productivity and stay organized.
Important Note: This project is for learning purposes and is based on the original script by me. The original repository can be found at TaskMan CLI repo.
✨ Features
- 📌 Add Tasks: Easily add new tasks to your to-do list
- 🗑️ Remove Tasks: Remove tasks from your to-do list
- ✅ Mark Tasks as Completed: Move tasks to a "done" list when completed
- 👀 View Current State: See all your tasks, both pending and completed
- 🧹 Clear Lists: Clean up your to-do and done lists with a single command
- 💾 Data Persistence: Your tasks are saved automatically, so you never lose your progress
- 📊 Generate Reports: Create daily task reports to track your productivity
🚀 Installation
You can install TaskMan CLI using pip:
pip install taskman-cli
🛠️ Usage
After installation, you can start TaskMan CLI by running:
taskman
Once launched, you'll see the TaskMan welcome screen. Type help
to see available commands:
TaskMan > help
Use the various commands to manage your tasks. Here are some examples:
TaskMan > add Buy groceries | Call mom | Finish report
TaskMan > list-todo
TaskMan > mark-as-done Buy groceries
TaskMan > list-both
📚 Available Commands
add [task1] | [task2] | ...
: Add one or more tasksremove [task1] | [task2] | ...
: Remove one or more tasksmark-as-done / mad [task1]...
: Mark one or more tasks as completedlist-both / lb
: Show all tasks (to-do and done)list-todo / ltd
: Show pending taskslist-done / ld
: Show completed tasksclear-todo / cltd
: Clear all pending tasksclear-done / cld
: Clear all completed tasksreset
: Clear all tasks (both to-do and done)report [name]
: Generate a report (optional custom name)save
: Save current state to filehelp
: Show the help messageclear / Ctrl+l
: Clear the screenexit
: Exit the program
💡 Tips
- Use the up and down arrow keys to navigate through your command history.
- TaskMan supports auto-completion. Start typing a command and press Tab to complete it.
- Your tasks can be saved, so you can safely exit with saving the current state and resume your work later.
🤝 Contributing
Contributions are welcome! Here's how you can contribute:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature
) - Commit your changes (
git commit -m 'Add some AmazingFeature'
) - Push to the branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Please make sure to update tests as appropriate.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Inspired by the ZTM Python course by Andrei Neagoie
- Built with love using Python and prompt_toolkit
📞 Contact
If you have any questions, feel free to reach out:
- Gmail - taha.y.adnan@gmail.com
- Project Link: TaskMan-CLI-PyPi
Made with ❤️ by Taha Yasser Adnan
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file taskman_cli-0.4.1.tar.gz
.
File metadata
- Download URL: taskman_cli-0.4.1.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 77bca06bea872d32f26953b14f0cfdefd7e0eec586060137e27e578fc0d1e1b3 |
|
MD5 | 4f0be5091180da396b0f40a2f569e937 |
|
BLAKE2b-256 | 9a748f10c4aedd4dffa9685a1dfedd1d7b28cafd51ca20c63ae17f13e1e49c5c |
File details
Details for the file taskman_cli-0.4.1-py3-none-any.whl
.
File metadata
- Download URL: taskman_cli-0.4.1-py3-none-any.whl
- Upload date:
- Size: 6.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 102118b271cc038866730266ebeb523eedcd3a88cfca65e1e2745c5267575d1f |
|
MD5 | 1df07f28e9c633617591f8bb97ef46a0 |
|
BLAKE2b-256 | 15b8b9f6c7bdee31887e4f56497b71e1acbbc222eeb01c4cfc009ba790e75808 |