| Name | todopkg JSON |
| Version |
1.0.7
JSON |
| download |
| home_page | |
| Summary | A To-Do List manager package for managing your tasks efficiently. |
| upload_time | 2023-11-08 18:35:55 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | |
| license | |
| keywords |
todo
list
project management
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Python Package Exercise
# todopkg
[](https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337/actions/workflows/main.yml)
`todopkg` is a Python package for managing and organizing to-do lists with prioritization and due dates. This package allows for easy creation, modification, and deletion of to-do lists and tasks.
## Features
- Create multiple to-do lists
- Add tasks with optional priority and due date
- Modify list names
- Delete tasks and lists
- Save and load lists from a file
- Command-line friendly display with table formatting
## PyPI
Click [Here](https://pypi.org/project/todopkg/) to view `todopkg` on PyPI.
# How to Use `todopkg`
### Installing Python
Please make sure you have Python 3.9 or above on your local machine, you can get the latest Python from its [official website](https://www.python.org/).
### Installing `todopkg`
To install `todopkg` via pip, run:
```bash
pip install todopkg
```
### Import `todopkg`
After installing `todopkg`, you can import `todopkg` to your program using:
```python
from todopkg import TodoListManager
```
## Documentation and Instruction
- **Create a to-do list instance:**
When you instantiate the manager, you have the option to specify the filename for saving and loading your to-do lists, as well as control the auto-restore feature that automatically loads existing to-do lists at startup.
`filename`: This optional parameter allows you to specify the name and path of the file where your to-do lists will be saved (it needs to be a json file). By default, it is set to 'todolist.json'.
`enable_auto_restore`: Also optional, this flag lets you decide whether to automatically load the to-do lists from the specified file when the manager is created. It is enabled by default.
- **Default:**
```python
todo_manager = TodoListManager()
```
- **Use custom storage file:**
```python
todo_manager = TodoListManager(filename = my_file.json)
```
- **Disable auto restore:**
```python
todo_manager = TodoListManager(enable_auto_restore = False)
```
- **Use custom storage file and Disable auto restore:**
```python
todo_manager = TodoListManager(filename = my_file.json, enable_auto_restore = False)
```
- **Create a new to-do list:**
Different to-do lists need to have distinct names.
**Create a to-do list named 'Groceries':**
```python
todo_manager.create_todo_list('Groceries')
```
**Create another to-do list named 'Homeworks':**
```python
todo_manager.create_todo_list('Homeworks')
```
- **Add items to the to-do list:**
To add an item to your to-do list, you'll use the `add_item_to_todo_list` function. You need to specify the name of the list and the item you wish to add. Items may be assigned a priority level (`int`) or a due date (`YYYY-MM-DD`), or both, and will be displayed in sorted order accordingly. When both are specified, priority ranking takes precedence over the due date.
- **Without priority or due date:**
```python
todo_manager.add_item_to_todo_list('Groceries', 'Apples')
```
- **With priority only (the lower the number, the higher the priority):**
```python
todo_manager.add_item_to_todo_list('Homeworks', 'Midterm Review', priority=1)
```
- **With due date only (due date in format "YYYY-MM-DD"):**
```python
todo_manager.add_item_to_todo_list('Homeworks', 'Essay', due_date="2023-11-10")
```
- **With both priority and due date:**
```python
todo_manager.add_item_to_todo_list('Homeworks', 'Essay', priority=2, due_date="2023-11-10")
```
- **Remove items from the to-do list:**
To remove an item, you need to specify the list name and the index of the item using `remove_item_from_todo_list` function. Indexing starts at 0, so to remove the first item, you would use index 0.
```python
todo_manager.remove_item_from_todo_list('Groceries', 0)
```
- **Update to-do list name:**
If you need to rename a to-do list, provide the current name followed by the new name to the `change_todo_list_name` function.
```python
todo_manager.change_todo_list_name('Groceries', 'Supermarket')
```
- **Delete to-do list:**
To completely remove a to-do list, simply provide the name of the list to the `delete_todo_list` function.
```python
todo_manager.delete_todo_list('Supermarket')
```
- **Show all to-do list:**
The `show_all_todo_list` function returns a dictionary containing all to-do lists with their items. Each key in the dictionary is a list name, and its value is a list of tasks.
```python
todo_manager.show_all_todo_list()
```
You can manipulate this dictionary however you like to integrate with your application. It provides a 'raw' format for advanced usage and flexibility.
- **Print all to-do lists:**
The `print_all_todo_lists` function provides a nicely formatted table output to the console for one or all of your to-do lists. You can either print all lists or specify a single list to print by name.
- **print all to-do lists:**
```python
todo_manager.print_all_todo_lists()
```
- **print a specific to-do list:**
```python
todo_manager.print_all_todo_lists(list_name = 'Groceries')
```
- **Displaying all items in a to-do list:**
To view all the items within a specific to-do list in a formatted, readable manner, you can use the `show_all_items_in_todo_list` function, pass the list's name as the parameter.
```python
todo_manager.show_all_items_in_todo_list('Groceries')
```
- **Save to-do lists to a JSON file:**
Save your to-do lists to a JSON file specified at the beginning using the `save_to_file` function. This functions is invoked automatically before program exit.
```python
todo_manager.save_to_file()
```
- **Load to-do lists from a JSON file:**
Restore your to-do lists from a JSON file specified at the beginning using `load_from_file` function. This function is automatically invoked upon instantiation of `TodoListManager` if `enable_auto_restore` is `True`.
```python
todo_manager.load_from_file()
```
## Example Program
For a full example program that utilizes all functionalities, kindly refer to [Example TodoList Usage](./src/todopkg/__main__.py).
You can also run this file following this procedure:
1. Clone the repository and cd to the project root directory:
```bash
git clone https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337.git
```
```bash
cd 3-python-package-exercise-isomorphism1337
```
2. Install `pipenv` if you don't have one on your machine:
```bash
pip install pipenv
```
3. Install the dependencies:
```bash
pipenv install --dev
pipenv shell
```
4. Run the example file:
```bash
python -m src.todopkg
```
---
# How to contribute to `todopkg`
## Prerequisites
- Python 3.9+
## Initial Setup
1. Clone the repository and cd to the project root directory:
```bash
git clone https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337.git
```
```bash
cd You_Own_Directory/3-python-package-exercise-isomorphism1337
```
2. Install `pipenv` if you don't have one on your machine:
```bash
pip install pipenv
```
3. Install the dependencies:
```bash
pipenv install --dev
pipenv shell
```
## Making Changes
1. Create a new branch for your feature or fix:
```bash
git checkout -b your-branch-name
```
2. Make your changes to the codebase. Remember to adhere to the project's coding standards and guidelines.
3. If you've added new code, consider writing tests that cover your changes in the [tests](./tests/) folder. This is important to ensure that your code works as expected and future changes don't break your implementation.
## Running Tests
After making changes, run all tests to ensure that your changes don't break any existing functionality:
```bash
pipenv run pytest
```
## Commiting Your Changes
Add your changes to staging, then commit your changes with a descriptive message:
```bash
git add .
```
```bash
git commit -m "Your detailed description of the changes"
```
## Pushing Changes
Push your changes to your branch:
```bash
git push origin your-branch-name
```
## Submitting a Pull Request
Create a new pull request for your branch, and we will review your code later.
## After Your Pull Request is Merged
1. Pull the changes from the original repository:
```bash
git checkout main
git pull origin main
```
2. Delete your old branch:
```bash
git branch -d your-branch-name
git push origin --delete your-branch-name
```
---
# Contributors
- [Jiasheng wang](https://github.com/isomorphismss)
- [Fuzhen Li](https://github.com/fzfzlfz)
- [Xuefeng Song](https://github.com/wowwowooo)
- [Yuantian Tan](https://github.com/AsukaTan)
# Conclusion
Thank you for taking the time to explore our project. We hope it serves your needs and contributes positively to your work. If you have any questions or feedback, feel free to reach out to us via [GitHub Discussions](https://docs.github.com/en/discussions) for our repository. We appreciate your interest and support!
Raw data
{
"_id": null,
"home_page": "",
"name": "todopkg",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "todo,list,project management",
"author": "",
"author_email": "isomorphism1337 group <jw6699@nyu.edu>",
"download_url": "https://files.pythonhosted.org/packages/dc/2a/e5521eeab56a12a874f5fc54ee5d15670192ff441b5a83ce97f7c34e94bf/todopkg-1.0.7.tar.gz",
"platform": null,
"description": "# Python Package Exercise\r\n# todopkg\r\n[](https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337/actions/workflows/main.yml)\r\n\r\n\r\n\r\n`todopkg` is a Python package for managing and organizing to-do lists with prioritization and due dates. This package allows for easy creation, modification, and deletion of to-do lists and tasks.\r\n\r\n## Features\r\n\r\n- Create multiple to-do lists\r\n- Add tasks with optional priority and due date\r\n- Modify list names\r\n- Delete tasks and lists\r\n- Save and load lists from a file\r\n- Command-line friendly display with table formatting\r\n\r\n## PyPI\r\nClick [Here](https://pypi.org/project/todopkg/) to view `todopkg` on PyPI.\r\n\r\n# How to Use `todopkg`\r\n\r\n### Installing Python\r\n\r\nPlease make sure you have Python 3.9 or above on your local machine, you can get the latest Python from its [official website](https://www.python.org/).\r\n\r\n### Installing `todopkg`\r\n\r\nTo install `todopkg` via pip, run:\r\n\r\n```bash\r\npip install todopkg\r\n```\r\n\r\n### Import `todopkg`\r\n\r\nAfter installing `todopkg`, you can import `todopkg` to your program using:\r\n\r\n ```python\r\n from todopkg import TodoListManager\r\n ```\r\n\r\n## Documentation and Instruction\r\n\r\n- **Create a to-do list instance:**\r\n\r\n When you instantiate the manager, you have the option to specify the filename for saving and loading your to-do lists, as well as control the auto-restore feature that automatically loads existing to-do lists at startup.\r\n\r\n `filename`: This optional parameter allows you to specify the name and path of the file where your to-do lists will be saved (it needs to be a json file). By default, it is set to 'todolist.json'.\r\n\r\n `enable_auto_restore`: Also optional, this flag lets you decide whether to automatically load the to-do lists from the specified file when the manager is created. It is enabled by default.\r\n\r\n - **Default:**\r\n\r\n ```python\r\n todo_manager = TodoListManager()\r\n ```\r\n\r\n - **Use custom storage file:**\r\n\r\n ```python\r\n todo_manager = TodoListManager(filename = my_file.json)\r\n ```\r\n - **Disable auto restore:**\r\n\r\n ```python\r\n todo_manager = TodoListManager(enable_auto_restore = False)\r\n ```\r\n - **Use custom storage file and Disable auto restore:**\r\n\r\n ```python\r\n todo_manager = TodoListManager(filename = my_file.json, enable_auto_restore = False)\r\n ```\r\n\r\n- **Create a new to-do list:**\r\n\r\n Different to-do lists need to have distinct names.\r\n\r\n **Create a to-do list named 'Groceries':**\r\n ```python\r\n todo_manager.create_todo_list('Groceries')\r\n ```\r\n **Create another to-do list named 'Homeworks':**\r\n ```python\r\n todo_manager.create_todo_list('Homeworks')\r\n ```\r\n- **Add items to the to-do list:**\r\n\r\n To add an item to your to-do list, you'll use the `add_item_to_todo_list` function. You need to specify the name of the list and the item you wish to add. Items may be assigned a priority level (`int`) or a due date (`YYYY-MM-DD`), or both, and will be displayed in sorted order accordingly. When both are specified, priority ranking takes precedence over the due date.\r\n - **Without priority or due date:**\r\n\r\n ```python\r\n todo_manager.add_item_to_todo_list('Groceries', 'Apples')\r\n ```\r\n - **With priority only (the lower the number, the higher the priority):**\r\n\r\n ```python\r\n todo_manager.add_item_to_todo_list('Homeworks', 'Midterm Review', priority=1)\r\n ```\r\n - **With due date only (due date in format \"YYYY-MM-DD\"):**\r\n\r\n ```python\r\n todo_manager.add_item_to_todo_list('Homeworks', 'Essay', due_date=\"2023-11-10\")\r\n ```\r\n - **With both priority and due date:**\r\n\r\n ```python\r\n todo_manager.add_item_to_todo_list('Homeworks', 'Essay', priority=2, due_date=\"2023-11-10\")\r\n ```\r\n- **Remove items from the to-do list:**\r\n \r\n To remove an item, you need to specify the list name and the index of the item using `remove_item_from_todo_list` function. Indexing starts at 0, so to remove the first item, you would use index 0.\r\n ```python\r\n todo_manager.remove_item_from_todo_list('Groceries', 0)\r\n ```\r\n\r\n- **Update to-do list name:**\r\n\r\n If you need to rename a to-do list, provide the current name followed by the new name to the `change_todo_list_name` function.\r\n\r\n ```python\r\n todo_manager.change_todo_list_name('Groceries', 'Supermarket')\r\n ```\r\n\r\n- **Delete to-do list:**\r\n\r\n To completely remove a to-do list, simply provide the name of the list to the `delete_todo_list` function.\r\n ```python\r\n todo_manager.delete_todo_list('Supermarket')\r\n ```\r\n\r\n- **Show all to-do list:**\r\n\r\n The `show_all_todo_list` function returns a dictionary containing all to-do lists with their items. Each key in the dictionary is a list name, and its value is a list of tasks.\r\n\r\n ```python\r\n todo_manager.show_all_todo_list()\r\n ```\r\n\r\n You can manipulate this dictionary however you like to integrate with your application. It provides a 'raw' format for advanced usage and flexibility.\r\n\r\n- **Print all to-do lists:**\r\n\r\n The `print_all_todo_lists` function provides a nicely formatted table output to the console for one or all of your to-do lists. You can either print all lists or specify a single list to print by name.\r\n\r\n - **print all to-do lists:**\r\n\r\n ```python\r\n todo_manager.print_all_todo_lists()\r\n ```\r\n - **print a specific to-do list:**\r\n ```python\r\n todo_manager.print_all_todo_lists(list_name = 'Groceries')\r\n ```\r\n- **Displaying all items in a to-do list:**\r\n\r\n To view all the items within a specific to-do list in a formatted, readable manner, you can use the `show_all_items_in_todo_list` function, pass the list's name as the parameter.\r\n\r\n ```python\r\n todo_manager.show_all_items_in_todo_list('Groceries')\r\n ```\r\n- **Save to-do lists to a JSON file:**\r\n\r\n Save your to-do lists to a JSON file specified at the beginning using the `save_to_file` function. This functions is invoked automatically before program exit.\r\n\r\n ```python\r\n todo_manager.save_to_file()\r\n ```\r\n- **Load to-do lists from a JSON file:**\r\n\r\n Restore your to-do lists from a JSON file specified at the beginning using `load_from_file` function. This function is automatically invoked upon instantiation of `TodoListManager` if `enable_auto_restore` is `True`.\r\n\r\n ```python\r\n todo_manager.load_from_file()\r\n ```\r\n\r\n## Example Program\r\n\r\nFor a full example program that utilizes all functionalities, kindly refer to [Example TodoList Usage](./src/todopkg/__main__.py). \r\n\r\nYou can also run this file following this procedure:\r\n1. Clone the repository and cd to the project root directory:\r\n\r\n ```bash\r\n git clone https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337.git\r\n ```\r\n\r\n ```bash\r\n cd 3-python-package-exercise-isomorphism1337\r\n ```\r\n\r\n2. Install `pipenv` if you don't have one on your machine:\r\n ```bash\r\n pip install pipenv\r\n ```\r\n\r\n3. Install the dependencies:\r\n\r\n ```bash\r\n pipenv install --dev\r\n pipenv shell\r\n ```\r\n4. Run the example file:\r\n\r\n ```bash\r\n python -m src.todopkg\r\n ```\r\n\r\n---\r\n\r\n# How to contribute to `todopkg`\r\n\r\n## Prerequisites\r\n\r\n- Python 3.9+\r\n\r\n## Initial Setup\r\n\r\n1. Clone the repository and cd to the project root directory:\r\n\r\n ```bash\r\n git clone https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337.git\r\n ```\r\n\r\n ```bash\r\n cd You_Own_Directory/3-python-package-exercise-isomorphism1337\r\n ```\r\n\r\n2. Install `pipenv` if you don't have one on your machine:\r\n\r\n ```bash\r\n pip install pipenv\r\n ```\r\n\r\n3. Install the dependencies:\r\n\r\n ```bash\r\n pipenv install --dev\r\n pipenv shell\r\n ```\r\n\r\n## Making Changes\r\n1. Create a new branch for your feature or fix:\r\n ```bash\r\n git checkout -b your-branch-name\r\n ```\r\n2. Make your changes to the codebase. Remember to adhere to the project's coding standards and guidelines.\r\n3. If you've added new code, consider writing tests that cover your changes in the [tests](./tests/) folder. This is important to ensure that your code works as expected and future changes don't break your implementation.\r\n\r\n## Running Tests\r\n\r\nAfter making changes, run all tests to ensure that your changes don't break any existing functionality:\r\n\r\n ```bash\r\n pipenv run pytest\r\n ```\r\n\r\n## Commiting Your Changes\r\n\r\nAdd your changes to staging, then commit your changes with a descriptive message:\r\n\r\n ```bash\r\n git add .\r\n ```\r\n ```bash\r\n git commit -m \"Your detailed description of the changes\"\r\n ```\r\n\r\n## Pushing Changes\r\n\r\nPush your changes to your branch:\r\n ```bash\r\n git push origin your-branch-name\r\n ```\r\n\r\n## Submitting a Pull Request\r\nCreate a new pull request for your branch, and we will review your code later.\r\n\r\n## After Your Pull Request is Merged\r\n\r\n1. Pull the changes from the original repository:\r\n ```bash\r\n git checkout main\r\n git pull origin main\r\n ```\r\n2. Delete your old branch:\r\n ```bash\r\n git branch -d your-branch-name\r\n git push origin --delete your-branch-name\r\n ```\r\n\r\n---\r\n\r\n# Contributors\r\n\r\n- [Jiasheng wang](https://github.com/isomorphismss)\r\n- [Fuzhen Li](https://github.com/fzfzlfz)\r\n- [Xuefeng Song](https://github.com/wowwowooo)\r\n- [Yuantian Tan](https://github.com/AsukaTan)\r\n\r\n# Conclusion\r\n\r\nThank you for taking the time to explore our project. We hope it serves your needs and contributes positively to your work. If you have any questions or feedback, feel free to reach out to us via [GitHub Discussions](https://docs.github.com/en/discussions) for our repository. We appreciate your interest and support!\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A To-Do List manager package for managing your tasks efficiently.",
"version": "1.0.7",
"project_urls": {
"homepage": "https://github.com/software-students-fall2023/3-python-package-exercise-isomorphism1337.git"
},
"split_keywords": [
"todo",
"list",
"project management"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7d57131e93c3ab76f93e147a3fa8d9af375b76817ce367f8d630e9425b0d1fbf",
"md5": "237874d7a42d2a1d5a0dbcb492a5f24c",
"sha256": "87fa4165ec25c66cbd46ea0c003d0628b8d8e72256897acf86abff4cb2c619a8"
},
"downloads": -1,
"filename": "todopkg-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "237874d7a42d2a1d5a0dbcb492a5f24c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 20636,
"upload_time": "2023-11-08T18:35:54",
"upload_time_iso_8601": "2023-11-08T18:35:54.116318Z",
"url": "https://files.pythonhosted.org/packages/7d/57/131e93c3ab76f93e147a3fa8d9af375b76817ce367f8d630e9425b0d1fbf/todopkg-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dc2ae5521eeab56a12a874f5fc54ee5d15670192ff441b5a83ce97f7c34e94bf",
"md5": "d517f9b621d605bea5507a4742fdecfa",
"sha256": "3e2e2358d245b91a362f0ecfea5056e8b0ff59d5026362f09f52b091bfba62f5"
},
"downloads": -1,
"filename": "todopkg-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "d517f9b621d605bea5507a4742fdecfa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 25639,
"upload_time": "2023-11-08T18:35:55",
"upload_time_iso_8601": "2023-11-08T18:35:55.358188Z",
"url": "https://files.pythonhosted.org/packages/dc/2a/e5521eeab56a12a874f5fc54ee5d15670192ff441b5a83ce97f7c34e94bf/todopkg-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-08 18:35:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "software-students-fall2023",
"github_project": "3-python-package-exercise-isomorphism1337",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "todopkg"
}
