# `mpyez`
Common use utilities for python done easy.
![GitHub-licence](https://img.shields.io/github/license/syedalimohsinbukhari/mpyez?style=for-the-badge&color=blue)
![GitHub top language](https://img.shields.io/github/languages/top/syedalimohsinbukhari/mpyez?color=green&style=for-the-badge)
![GitHub contributors](https://img.shields.io/github/contributors/syedalimohsinbukhari/mpyez?style=for-the-badge)
![Github Issues](https://img.shields.io/github/issues/syedalimohsinbukhari/mpyez?color=red&style=for-the-badge)
![GitHub PRs](https://img.shields.io/github/issues-pr/syedalimohsinbukhari/mpyez?color=maroon&style=for-the-badge)
## What is `mpyez`
`mpyez` is a library made specifically to make the daily mundane tasks as easily doable as possible.
* Want to get a list of all python files in your folder? Use `ListOfFilesFromExtensions` class.
* Want to convert a nested list to a 1D list? Use `nested_list_to_list()`.
* Want to convert a simple list to nested list? Use `list_to_nested_list()`.
This library is intended to lower complexity of daily recurring tasks.
## How to install
Use pip: `pip install mpyez`
## Examples
Let's say, you want to convert a nested list
`>>> my_nested_list = [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10]]`
to a 1D list, with `mpyez` you can do it using `nested_list_to_list` function in `ez_list` module (see, Current
implementations for details).
`>>> nested_list_to_list(my_nested_list)`
`>>> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]`
## Modules
### Current Implementations
---
1. `os_`
1. `ListOfFilesFromExtensions`: To pick files of specific extensions.
2. `ListOfFilesFromNames`: To pick files matching a specific name pattern.
3. `move_directory_contents`: To move directory contents to a new location.
2. `list_`
1. `difference_between_lists`: To get the difference between two lists.
2. `equal_lists`: To check if two lists are equal.
3. `get_object_count`: To get an object count from the list.
4. `index`: To get the index of an element in the list.
5. `is_contained`: To check if a list is contained within another list.
6. `join_lists`: To join multiple lists into a single one.
7. `list_to_nested_list`: To convert a list to a nested list.
8. `move_element_in_list`: To move a list element to a new position.
9. `nested_list_to_list`: To convert a nested list to a flat list.
10. `remove_`: To remove a value from a list.
11. `replace_at_index`: To replace values at a specific index in the list.
12. `replace_with_value`: To replace values with a given value in the list.
13. `sort_`: To sort a list.
14. `string_list_to_numeric`: To convert string values in a list to numeric.
3. `read_files`
1. `read_txt_file`: To read an entire text file.
2. `get_lines_from_txt_file`: To read specific lines from a text file.
4. `dict_`
1. `get_key_index`: To get the index of a key in a dictionary.
2. `merge_dictionaries`: To merge dictionaries.
3. `pretty_print`: To print a dictionary in a readable format.
4. `sort_dictionary`: To sort a dictionary.
5. `array_`
1. `moving_average`: To calculate the moving average for an array.
2. `reshape_with_padding`: To reshape an array with padding.
3. `transpose1d`: To transpose a 1D array.
6. `plotting_`
1. `plot_two_column_file`: To plot data from a two-column file.
2. `plot_xy`: To plot x vs. y data.
3. `plot_with_dual_axes`: To plot with dual axes for two datasets.
---
### Future Implementations
1. `read_files`
1. Implementation of reading other file formats, especially `.csv`.
2. Whole file reading using generators to reduce memory issues.
2. `dict_`
1. Additional dictionary manipulation methods such as updating, retrieval, and comparisons.
Raw data
{
"_id": null,
"home_page": "https://github.com/syedalimohsinbukhari/mpyez",
"name": "mpyez",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Syed Ali Mohsin Bukhari",
"author_email": "syedali.b@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/8f/26/2ec3cbc543ab682c8acf874fd556587b43ea8ea72f96c52def1b25c3f04a/mpyez-0.1.0.tar.gz",
"platform": null,
"description": "# `mpyez`\n\nCommon use utilities for python done easy.\n\n![GitHub-licence](https://img.shields.io/github/license/syedalimohsinbukhari/mpyez?style=for-the-badge&color=blue)\n![GitHub top language](https://img.shields.io/github/languages/top/syedalimohsinbukhari/mpyez?color=green&style=for-the-badge)\n![GitHub contributors](https://img.shields.io/github/contributors/syedalimohsinbukhari/mpyez?style=for-the-badge)\n![Github Issues](https://img.shields.io/github/issues/syedalimohsinbukhari/mpyez?color=red&style=for-the-badge)\n![GitHub PRs](https://img.shields.io/github/issues-pr/syedalimohsinbukhari/mpyez?color=maroon&style=for-the-badge)\n\n## What is `mpyez`\n\n`mpyez` is a library made specifically to make the daily mundane tasks as easily doable as possible.\n\n* Want to get a list of all python files in your folder? Use `ListOfFilesFromExtensions` class.\n* Want to convert a nested list to a 1D list? Use `nested_list_to_list()`.\n* Want to convert a simple list to nested list? Use `list_to_nested_list()`.\n\nThis library is intended to lower complexity of daily recurring tasks.\n\n## How to install\n\nUse pip: `pip install mpyez`\n\n## Examples\n\nLet's say, you want to convert a nested list\n\n`>>> my_nested_list = [[1, 2, 3, 4], [5, 6, 7, 8], [9, 10]]`\n\nto a 1D list, with `mpyez` you can do it using `nested_list_to_list` function in `ez_list` module (see, Current\nimplementations for details).\n\n`>>> nested_list_to_list(my_nested_list)`\n\n`>>> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]`\n\n## Modules\n\n### Current Implementations\n\n---\n\n1. `os_`\n 1. `ListOfFilesFromExtensions`: To pick files of specific extensions.\n 2. `ListOfFilesFromNames`: To pick files matching a specific name pattern.\n 3. `move_directory_contents`: To move directory contents to a new location.\n\n2. `list_`\n 1. `difference_between_lists`: To get the difference between two lists.\n 2. `equal_lists`: To check if two lists are equal.\n 3. `get_object_count`: To get an object count from the list.\n 4. `index`: To get the index of an element in the list.\n 5. `is_contained`: To check if a list is contained within another list.\n 6. `join_lists`: To join multiple lists into a single one.\n 7. `list_to_nested_list`: To convert a list to a nested list.\n 8. `move_element_in_list`: To move a list element to a new position.\n 9. `nested_list_to_list`: To convert a nested list to a flat list.\n 10. `remove_`: To remove a value from a list.\n 11. `replace_at_index`: To replace values at a specific index in the list.\n 12. `replace_with_value`: To replace values with a given value in the list.\n 13. `sort_`: To sort a list.\n 14. `string_list_to_numeric`: To convert string values in a list to numeric.\n\n3. `read_files`\n 1. `read_txt_file`: To read an entire text file.\n 2. `get_lines_from_txt_file`: To read specific lines from a text file.\n\n4. `dict_`\n 1. `get_key_index`: To get the index of a key in a dictionary.\n 2. `merge_dictionaries`: To merge dictionaries.\n 3. `pretty_print`: To print a dictionary in a readable format.\n 4. `sort_dictionary`: To sort a dictionary.\n\n5. `array_`\n 1. `moving_average`: To calculate the moving average for an array.\n 2. `reshape_with_padding`: To reshape an array with padding.\n 3. `transpose1d`: To transpose a 1D array.\n\n6. `plotting_`\n 1. `plot_two_column_file`: To plot data from a two-column file.\n 2. `plot_xy`: To plot x vs. y data.\n 3. `plot_with_dual_axes`: To plot with dual axes for two datasets.\n\n---\n\n### Future Implementations\n\n1. `read_files`\n 1. Implementation of reading other file formats, especially `.csv`.\n 2. Whole file reading using generators to reduce memory issues.\n\n2. `dict_`\n 1. Additional dictionary manipulation methods such as updating, retrieval, and comparisons.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Common use utilities for python done easy.",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/syedalimohsinbukhari/mpyez"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1c1771ea5e4420ccdbac1879c693021826e1348451b9e56e6ecd00eb413792bf",
"md5": "dc22b5d08df4e48e24a82bdddd0a3521",
"sha256": "46199d1443f007dc4a65aa3cbfbd132e246cc5b17ef0d3c0f90a0f3ae3cdeaa0"
},
"downloads": -1,
"filename": "mpyez-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dc22b5d08df4e48e24a82bdddd0a3521",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 31748,
"upload_time": "2024-12-08T05:00:40",
"upload_time_iso_8601": "2024-12-08T05:00:40.453987Z",
"url": "https://files.pythonhosted.org/packages/1c/17/71ea5e4420ccdbac1879c693021826e1348451b9e56e6ecd00eb413792bf/mpyez-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8f262ec3cbc543ab682c8acf874fd556587b43ea8ea72f96c52def1b25c3f04a",
"md5": "e4e2fbd29f208e4b1cef168d76362c5f",
"sha256": "0b5c4ef733a1bfa6221e79b047e43ced154e48ad96268cfc19c75a6f58380893"
},
"downloads": -1,
"filename": "mpyez-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "e4e2fbd29f208e4b1cef168d76362c5f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 27790,
"upload_time": "2024-12-08T05:00:41",
"upload_time_iso_8601": "2024-12-08T05:00:41.967242Z",
"url": "https://files.pythonhosted.org/packages/8f/26/2ec3cbc543ab682c8acf874fd556587b43ea8ea72f96c52def1b25c3f04a/mpyez-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-08 05:00:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "syedalimohsinbukhari",
"github_project": "mpyez",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
"<",
"2.1.0"
]
]
},
{
"name": "matplotlib",
"specs": []
},
{
"name": "setuptools",
"specs": []
}
],
"lcname": "mpyez"
}